Este artículo trae el paso a paso de cada asistente para conectar tu área de trabajo de Coodesh mediante MCP (Model Context Protocol). Si todavía no sabes qué es el MCP ni qué permisos recibe el asistente, empieza por ¿Cómo conectar su asistente de IA (MCP)?.

Antes de empezar

El MCP está disponible para cuentas de empresa. Necesitas estar conectado en Coodesh y formar parte de al menos un área de trabajo.

Estos son los únicos datos que cualquier asistente va a pedir:

Dirección del servidor: https://coodesh.com/mcp
Tipo de conexión: servidor remoto, transporte Streamable HTTP (algunos clientes lo llaman HTTP). No elijas SSE ni stdio.
Autenticación: OAuth, hecha en el navegador.

No existe una clave de API para pegar. Si el asistente pide un token o un encabezado de autenticación, déjalo vacío: la autorización ocurre en el navegador, en la pantalla de Coodesh.

Claude Code (terminal)

En la terminal, agrega el servidor:

claude mcp add --transport http --scope user coodesh https://coodesh.com/mcp

El --scope user deja la conexión disponible en todos tus proyectos. Sin él, el servidor vale solo para la carpeta en la que estabas.

Luego:

Abre Claude Code y escribe /mcp.
Selecciona coodesh y después Authenticate. El navegador abre la pantalla de autorización de Coodesh.
Inicia sesión, elige las áreas de trabajo y haz clic en Autorizar.
Para comprobarlo, ejecuta claude mcp list. El servidor debe aparecer como Connected.

Claude Desktop y claude.ai

Planes Free, Pro y Max:

Ve a Configuración > Personalizar > Conectores.
Haz clic en Agregar conector personalizado.
Indica la URL https://coodesh.com/mcp y haz clic en Agregar. Deja vacíos los campos de OAuth y de encabezados.
Haz clic en Conectar y termina la autorización en el navegador.

Planes Team y Enterprise: solo el propietario de la organización agrega el conector, en Configuración de la organización > Conectores > Agregar > Personalizado (si Claude pregunta el tipo, elige Web). Después, cada persona del equipo va a Personalizar > Conectores y hace clic en Conectar para autorizar con su propia cuenta de Coodesh.

Dentro de la conversación, usa el botón + para activar o desactivar el conector.

ChatGPT (aplicación)

Abre Configuración > Servidores MCP y haz clic en Agregar servidor.
Ponle el nombre Coodesh, elige Streamable HTTP e indica la URL https://coodesh.com/mcp.
Guarda y haz clic en Reiniciar.
En la lista de servidores, haz clic en Autenticar y termina la autorización en el navegador.
Para comprobarlo, escribe /mcp en el campo de mensaje: el servidor debe aparecer entre los conectados.

Codex (línea de comandos)

Abre el archivo ~/.codex/config.toml y agrega:

[mcp_servers.coodesh]
url = "https://coodesh.com/mcp"

No completes token ni encabezados: Codex ya usa OAuth por defecto para servidores remotos. Luego ejecuta codex mcp login coodesh y termina la autorización en el navegador. Para comprobarlo, ejecuta codex mcp list.

GitHub Copilot (VS Code)

Con el asistente de configuración:

Abre la paleta de comandos (Ctrl+Shift+P o Cmd+Shift+P) y ejecuta MCP: Add Server.
Elige HTTP, indica la URL https://coodesh.com/mcp y el nombre coodesh.
Elige dónde guardarlo: tu perfil de usuario, que vale para todos los proyectos, o solo el proyecto actual, en .vscode/mcp.json.

O editando el archivo directamente:

{
  "servers": {
    "coodesh": {
      "type": "http",
      "url": "https://coodesh.com/mcp"
    }
  }
}

Después de guardar, haz clic en Start y en Auth, en los atajos que aparecen justo encima de la configuración del servidor, y termina la autorización en el navegador. En Copilot Chat, cambia al modo Agent y haz clic en el icono de herramientas para ver lo que Coodesh puso a disposición.

En Visual Studio, JetBrains y Xcode la configuración es la misma: un servidor remoto de tipo HTTP apuntando a la misma URL.

Cómo saber si funcionó

Pídele algo simple al asistente, como "¿a qué áreas de trabajo de Coodesh puedo acceder?". Debe responder con tu nombre y la lista de áreas que autorizaste. Si responde que no tiene acceso a ninguna herramienta de Coodesh, la conexión todavía no fue autorizada.

Con la conexión activa, el asistente puede, por ejemplo:

consultar vacantes, el panel de vacantes y candidaturas, y cambiar el estado de una candidatura;
listar y ver evaluaciones, e invitar personas a una evaluación;
consultar la biblioteca de preguntas de Coodesh y la biblioteca de tu empresa;
consultar las personas del área de trabajo y el plan contratado.

Si algo sale mal

La dirección tiene que terminar en /mcp, sin barra final. https://coodesh.com por sí solo no funciona.
Elige siempre HTTP (Streamable HTTP). Si el cliente intenta SSE o stdio, la conexión falla.
"Authentication required" o el error 401 antes de autorizar es esperado. Es el servidor pidiendo el inicio de sesión. Usa el paso de autenticación de tu asistente: /mcp en Claude Code, Autenticar en ChatGPT, codex mcp login en Codex, Auth en VS Code.
El navegador no abrió, o la pantalla expiró. La autorización vale 10 minutos. Repite el paso de autenticación y termínalo sin pausas largas.
El asistente pide un token o clave de API. No tenemos clave para MCP. Deja el campo vacío y termina en el navegador.
No aparece ninguna área de trabajo en la pantalla de autorización. Tu cuenta tiene que ser de empresa y tener perfil de administrador, gestor o usuario de empresa en al menos un área de trabajo. Pide a quien administra la cuenta que te incluya.
El asistente no ve un área de trabajo nueva. El acceso se fija en el momento de la autorización. Reconecta y marca el área que faltaba.
Cambiaste de cuenta en Coodesh. Desconecta el asistente en Mi cuenta > Seguridad y conéctalo de nuevo con la cuenta correcta.

Permisos y desconexión

El asistente nunca tiene más permisos que los que tú ya tienes, y el acceso vale solo para las áreas de trabajo que seleccionaste. Para revisarlo o revocarlo, ve a Mi cuenta > Seguridad, en la tarjeta Asistentes conectados. El detalle de cada permiso está en ¿Cómo conectar su asistente de IA (MCP)?.

Cómo configurar el MCP en Claude, ChatGPT, Codex y Copilot