# MCP Teamwork (by eCortesCL) > Servidor MCP remoto para operar Teamwork (proyectos, listas, tareas, subtareas, comentarios, horas, archivos, enlaces, hitos, personas y empresas) desde cualquier IA, con cuentas por usuario y permisos que el servidor exige. ## Conexión - Endpoint MCP (Streamable HTTP, sin estado): https://mcp-teamwork.ecortes.cl/mcp - Autenticación: OAuth 2.1 propio (registro dinámico de clientes, PKCE S256, scope `mcp`). Metadatos: - https://mcp-teamwork.ecortes.cl/.well-known/oauth-authorization-server - https://mcp-teamwork.ecortes.cl/.well-known/oauth-protected-resource - Sin token, /mcp responde 401 con `WWW-Authenticate: Bearer resource_metadata="…"`. - Alternativa sin OAuth: token personal creado en el panel (`Authorization: Bearer mtw_pat_…`). Nunca se usan API keys en la URL. - Credenciales de Teamwork: cada usuario enlaza su token en el panel (https://mcp-teamwork.ecortes.cl/accounts); se guarda cifrado y nunca pasa por el chat. ## Primeros pasos para la IA 1. Llama `teamwork_list_accounts`: muestra las cuentas enlazadas y qué está PERMITIDO en cada una. 2. Busca ids con `teamwork_list_projects`, `teamwork_list_tasklists`, `teamwork_search` o `teamwork_list_people`. No inventes ids. 3. Si una escritura responde `status: confirmation_required`, muestra la vista previa al usuario y repite con `confirm=true` solo si la aprueba. Los borrados SIEMPRE la piden. ## Herramientas (42) ### Cuentas y búsqueda - `teamwork_list_accounts`: Cuentas Teamwork enlazadas - `teamwork_search`: Buscar en Teamwork - `teamwork_get_url`: Enlace directo en Teamwork ### Proyectos y listas - `teamwork_list_projects`: Listar proyectos - `teamwork_get_project`: Detalle de un proyecto - `teamwork_list_tasklists`: Listas de tareas de un proyecto - `teamwork_create_project` (escribe): Crear proyecto - `teamwork_update_project` (escribe): Editar proyecto - `teamwork_get_tasklist`: Detalle de una lista de tareas - `teamwork_create_tasklist` (escribe): Crear lista de tareas - `teamwork_update_tasklist` (escribe): Editar lista de tareas ### Tareas - `teamwork_list_tasks`: Listar tareas - `teamwork_get_task`: Detalle de una tarea - `teamwork_create_task` (escribe): Crear tarea - `teamwork_update_task` (escribe): Editar tarea - `teamwork_set_task_complete` (escribe): Completar o reabrir tarea - `teamwork_delete_task` (escribe): Borrar tarea - `teamwork_list_subtasks`: Subtareas de una tarea - `teamwork_task_metrics`: Resumen de tareas (atrasadas, hoy, esta semana) ### Comentarios - `teamwork_list_comments`: Listar comentarios - `teamwork_get_comment`: Ver un comentario - `teamwork_add_comment` (escribe): Comentar ### Archivos y enlaces - `teamwork_list_files`: Listar archivos - `teamwork_get_file`: Detalle de un archivo - `teamwork_get_file_link`: Enlace para compartir un archivo - `teamwork_download_file`: Descargar / leer un archivo - `teamwork_upload_file` (escribe): Subir archivo a una tarea - `teamwork_delete_file` (escribe): Borrar archivo - `teamwork_list_links`: Enlaces de un proyecto - `teamwork_get_link`: Ver un enlace - `teamwork_create_link` (escribe): Crear enlace en un proyecto - `teamwork_update_link` (escribe): Editar enlace - `teamwork_delete_link` (escribe): Borrar enlace ### Horas - `teamwork_list_time`: Horas registradas - `teamwork_log_time` (escribe): Registrar horas - `teamwork_list_timezones`: Zonas horarias ### Hitos, personas y empresas - `teamwork_list_milestones`: Listar hitos - `teamwork_list_people`: Listar personas - `teamwork_get_person`: Ver una persona - `teamwork_list_companies`: Listar empresas (clientes) - `teamwork_get_company`: Ver una empresa ### Avanzado - `teamwork_api` (escribe): API de Teamwork (avanzado) ## Más - Referencia completa con parámetros: https://mcp-teamwork.ecortes.cl/llms-full.txt - Panel: https://mcp-teamwork.ecortes.cl/ - Salud: https://mcp-teamwork.ecortes.cl/healthz