Cómo conectar Claude a tu herramienta de gestión de proyectos con MCP

Qué es MCP

El Model Context Protocol (MCP) es un estándar abierto que permite a un asistente de IA usar herramientas de otra aplicación. Un gestor de proyectos con servidor MCP publica una lista de herramientas, como "listar mis issues" o "crear un issue", y un cliente como Claude Code las llama por ti, dentro de los permisos que concedas.

En la práctica, eso supone tres cosas. El asistente trabaja con el tablero real y no con lo que hayas pegado. Puede actuar, no solo sugerir. Y cada acción pasa por los controles de permisos de la propia herramienta, así que solo puede hacer lo que tú mismo podrías hacer.

Qué necesitas antes de empezar

• Una cuenta en la herramienta. En Atrix, eso es un workspace. No hay plan gratuito: cada workspace empieza con una prueba de 7 días del plan Builder, con tarjeta, y el servidor MCP está incluido en todos los planes.
• La dirección del servidor. En Atrix es https://atrix.dev/api/mcp, servida por Streamable HTTP.
• Un cliente. Claude Code, Claude en la web o en el escritorio, Cursor o cualquier otro que hable MCP por HTTP.

No necesitas crear una clave de API para ninguno de los clientes de abajo. Todos inician sesión desde el navegador con OAuth.

Conectar Claude Code

Claude Code es la mejor opción si quieres un asistente que lea tu código y tu tablero en la misma sesión.

1. Añade el servidor. El comando no lleva ninguna credencial:

   claude mcp add --transport http atrix https://atrix.dev/api/mcp
   

2. Abre Claude Code, ejecuta /mcp, selecciona atrix y elige Authenticate.

3. Se abre una ventana del navegador. Inicia sesión, elige el workspace y aprueba los scopes. La primera conexión solo pide lectura.

4. De vuelta en la terminal, comprueba que funciona:

   Who am I connected to Atrix as, and what can you do?
   

   Claude llama a atrix_whoami, que indica la persona, el workspace, los scopes que tiene la conexión y qué herramientas puede usar.

Para CI o un servidor sin navegador, puedes pasar un token personal. Créalo en Atrix en Settings → Atrix Tokens y guárdalo en una variable de entorno:

claude mcp add --transport http atrix https://atrix.dev/api/mcp \
  --header "Authorization: Bearer $ATRIX_TOKEN"

En un portátil, mejor el inicio de sesión por navegador. Un token OAuth renovable y revocable es mejor cosa para tener en disco que una clave de larga duración.

Conectar Claude y Claude Desktop

Claude en la web y Claude Desktop usan conectores personalizados.

1. Abre Settings → Connectors → Add custom connector (Configuración → Conectores → Añadir conector personalizado).

2. Ponle un nombre y pega el endpoint:

   https://atrix.dev/api/mcp
   

3. Selecciona Connect e inicia sesión en Atrix en la ventana que se abre.

Claude se registra solo en el servidor, así que no hay que crear ningún client ID ni secreto. Si usas un plan de empresa de Claude, puede que un administrador tenga que permitir los conectores personalizados antes de que puedas añadir uno.

Conectar Cursor

Cursor, y la mayoría de clientes que hablan Streamable HTTP, aceptan el mismo JSON. Ponlo en .cursor/mcp.json dentro de un proyecto, o en ~/.cursor/mcp.json para usarlo en todas partes:

{
  "mcpServers": {
    "atrix": { "url": "https://atrix.dev/api/mcp" }
  }
}

Cursor abre el navegador para iniciar sesión la primera vez que se llama a una herramienta. Si prefieres usar un token:

{
  "mcpServers": {
    "atrix": {
      "url": "https://atrix.dev/api/mcp",
      "headers": { "Authorization": "Bearer atx_pat_…" }
    }
  }
}

Cómo funcionan los permisos una vez conectado

La primera conexión es de solo lectura a propósito. Así ves qué hace Claude con tu tablero antes de que pueda cambiar nada.

Cuando pides algo que escribe, como crear un issue, el servidor responde 403 insufficient_scope e indica el scope que falta. Un cliente bien hecho vuelve a abrir el navegador para que apruebes exactamente ese scope y nada más. Si tu cliente no lo hace, vuelve a autenticarte (en Claude Code, /mcp) y aprueba ahí el scope adicional.

Hay unas reglas que se cumplen en todas las conexiones:

• Los scopes restringen, nunca amplían. Una conexión nunca puede hacer más que la persona que la aprobó. Conceder crm.value no muestra importes de deals a quien no tiene permiso para verlos.
• Los permisos se comprueban en cada llamada. Si alguien pierde el acceso en el workspace, todas las conexiones que creó lo pierden en ese mismo momento.
• Los límites son por conexión: 120 llamadas y 30 escrituras por minuto. Por encima, el servidor responde 429 con una cabecera Retry-After.
• Cada llamada queda auditada: la herramienta, el scope y el resultado, registrados con ids y nunca con contenidos.
• Los sueldos nunca son accesibles. Ningún scope llega a un salario.

Prompts que funcionan de verdad

Estos prompts corresponden directamente a herramientas del servidor de Atrix. No hace falta nombrar la herramienta; Claude la elige. Los nombres aparecen para que sepas qué esperar en la petición de aprobación.

Empezar el día

• "What's overdue for me this week?" (¿Qué tengo vencido esta semana?) usa attention_today, que devuelve tu trabajo vencido y el que vence esta semana, las menciones sin leer y las reuniones de hoy.
• "¿Cómo va el producto Website? ¿Qué está atascado?" usa project_status: porcentaje completado, trabajo por estado y lo que lleve más de una semana en revisión o en curso.

Buscar y leer

• "Busca la especificación de precios y resume las preguntas abiertas." usa search y luego fetch. La búsqueda encuentra coincidencias en el cuerpo de las páginas, no solo en los títulos.
• "Enséñame todo lo asignado a Zara que esté en revisión." usa people_find y work_list_issues.

Crear y cambiar trabajo (requiere work.write)

• "Crea un issue en Website: 'Arreglar el enlace de precios roto en el pie de página', prioridad alta, para el viernes, asígnamelo." usa work_create_issue, y después work_schedule_issue y work_assign_issue.
• "Pasa los tres bugs del checkout a In review y añade un comentario diciendo que el arreglo está en staging." usa work_bulk_update y work_comment_issue.

Del código al tablero (Claude Code)

• "Lee los comentarios TODO de src/billing y crea una tarea por cada TODO en Website. Sin duplicados." Claude lee los archivos en local y llama a work_create_issue con ifNotExists, que devuelve un issue abierto con el mismo título en lugar de crearlo dos veces.

Hay algo que el servidor rechaza a propósito: un asistente no puede crear una épica. Las épicas son la forma en que tú enmarcas el trabajo, así que Claude abre historias, tareas y bugs y les asigna la épica como padre.

Qué revisar en el servidor MCP de cualquier gestor de proyectos

Atrix es una opción. Conectes la herramienta que conectes, revisa esto antes de dar a un asistente permiso de escritura.

1. OAuth o clave de API. OAuth significa un token con scopes que aprobaste en una pantalla de consentimiento y que puedes revocar sin rotar nada más. Una clave de API pegada suele poder hacer todo lo que puede tu cuenta y vive en un archivo de configuración.
2. Scopes. ¿Puedes conceder lectura sin escritura? ¿Puedes separar proyectos, clientes y datos de personas? Si la única opción es "todo", trata la conexión como tratarías tu contraseña.
3. Aprobación de escrituras. ¿Pregunta el cliente antes de cada escritura, y marca el servidor qué herramientas son de solo lectura? Un modelo que malinterpreta una petición debería toparse con una confirmación, no con tus datos.
4. Auditoría. ¿Puedes ver qué hizo una conexión y cuándo? Un registro de llamadas es la forma de responder "¿quién cerró estos veinte issues?".
5. Límites de uso. Un bucle descontrolado debería pararse en un límite, no al final de tu backlog.
6. Lo que lee el modelo. El modelo lee el texto y los comentarios de los tickets. Alguien puede escribir instrucciones en un ticket, así que mantén activadas las aprobaciones de escritura para todo lo que importe.

Si algo sale mal

• 401: la sesión caducó o se revocó. Ejecuta /mcp y vuelve a autenticarte.
• 403 insufficient_scope: a la conexión le falta un scope. Apruébalo cuando se abra el navegador o vuelve a conectar con él.
• 403 sin scope indicado: el scope está, pero tu cuenta no tiene el permiso en el workspace. Pídeselo a un administrador del workspace.
• 429: espera los segundos que indica Retry-After. Reintentar en bucle solo alarga la espera.

Preguntas frecuentes

¿Hay alguna forma gratuita de conectar Claude a Atrix?

No. Atrix no tiene plan gratuito. Cada workspace empieza con una prueba de 7 días del plan Builder, con tarjeta, y el servidor MCP está incluido desde el primer día. Builder cuesta 39 $ al mes con 5 plazas y Studio 149 $ al mes con 15; los planes anuales tienen un 20 % de descuento.

¿Puede Claude cambiar mi tablero sin preguntar?

No en la primera conexión, que es de solo lectura. Escribir requiere un scope que apruebas en el navegador, y clientes como Claude Code también preguntan antes de ejecutar una herramienta, salvo que les hayas dicho que no lo hagan.

¿Ve Atrix mi conversación con Claude?

No. El servidor solo ve las llamadas a herramientas que hace Claude, como una consulta de búsqueda o los campos de un issue que crea. El registro de auditoría guarda ids, no contenidos.

¿Qué cliente debería usar?

Usa Claude Code cuando el trabajo nace en tu código, por ejemplo para convertir TODOs o un test que falla en issues. Usa Claude o Claude Desktop para planificar, preguntar por el estado y redactar. Usa Cursor si es donde ya trabajas. Los tres llegan a las mismas herramientas con los mismos límites.

¿Cómo me desconecto?

Elimina el servidor en el cliente (claude mcp remove atrix en Claude Code) y revoca la conexión en la configuración de Atrix. Al revocarla en Atrix deja de funcionar en la siguiente petición.

Pruébalo con tu propio tablero

Crea un workspace desde precios, conecta Claude con los pasos anteriores y pregúntale qué tienes vencido. La guía del servidor MCP explica la configuración de cada cliente, y la referencia de herramientas recoge todas las herramientas con su scope y sus parámetros. Para una visión general, consulta Atrix con Claude y la página de MCP.