Ir al contenido principal

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

Paso a paso para conectar cada asistente de IA a tu área de trabajo de Coodesh, con los comandos de cada cliente y qué hacer cuando la conexión falla.

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:

  1. Abre Claude Code y escribe /mcp.

  2. Selecciona coodesh y después Authenticate. El navegador abre la pantalla de autorización de Coodesh.

  3. Inicia sesión, elige las áreas de trabajo y haz clic en Autorizar.

  4. Para comprobarlo, ejecuta claude mcp list. El servidor debe aparecer como Connected.

Claude Desktop y claude.ai

Planes Free, Pro y Max:

  1. Ve a Configuración > Personalizar > Conectores.

  2. Haz clic en Agregar conector personalizado.

  3. Indica la URL https://coodesh.com/mcp y haz clic en Agregar. Deja vacíos los campos de OAuth y de encabezados.

  4. 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)

  1. Abre Configuración > Servidores MCP y haz clic en Agregar servidor.

  2. Ponle el nombre Coodesh, elige Streamable HTTP e indica la URL https://coodesh.com/mcp.

  3. Guarda y haz clic en Reiniciar.

  4. En la lista de servidores, haz clic en Autenticar y termina la autorización en el navegador.

  5. 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:

  1. Abre la paleta de comandos (Ctrl+Shift+P o Cmd+Shift+P) y ejecuta MCP: Add Server.

  2. Elige HTTP, indica la URL https://coodesh.com/mcp y el nombre coodesh.

  3. 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.

Microsoft 365 Copilot

Microsoft 365 Copilot, el asistente que viene con Office y Teams, no acepta un servidor MCP directamente en la conversación. La conexión se hace una vez en Copilot Studio, por quien administra, y se convierte en un agente publicado para el equipo. Hace falta licencia de Copilot Studio y permiso para crear agentes.

  1. Abre Copilot Studio y elige, o crea, el agente que va a usar los datos de Coodesh.

  2. Ve a Herramientas (Tools) y haz clic en Agregar una herramienta > Nueva herramienta > Model Context Protocol.

  3. Indica el nombre del servidor (Coodesh), una descripción corta de lo que hace y la URL https://coodesh.com/mcp. La descripción importa: es lo que usa el agente para decidir cuándo consultar a Coodesh.

  4. En autenticación, elige OAuth 2.0 y, en el tipo, Detección dinámica (Dynamic discovery). No completes el ID ni el secreto de cliente: nuestro servidor registra el cliente solo. Haz clic en Crear.

  5. En la pantalla Agregar herramienta, haz clic en Crear una nueva conexión, termina la autorización en el navegador y luego en Agregar al agente.

  6. Publica el agente. En Canales, abre Teams y Microsoft 365 Copilot, deja marcado Hacer que el agente esté disponible en Microsoft 365 Copilot y haz clic en Agregar canal.

  7. En Opciones de disponibilidad, elige entre mostrar el agente a los colegas con quienes lo compartiste o enviarlo a la aprobación del administrador, que es lo que lo deja visible para toda la organización.

Para usarlo, abre Microsoft 365 Copilot, escribe @ y elige el agente. Cada persona autoriza con su propia cuenta de Coodesh la primera vez y ve solo las áreas de trabajo que ella misma marcó.

La ruta por el centro de administración de Microsoft 365 (Copilot > Conectores > Conectar al servidor MCP) no sirve para Coodesh: exige un registro OAuth con ID y secreto de cliente en el Portal para Desarrolladores de Teams, y nosotros no emitimos secreto de cliente. Usa Copilot Studio.

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.

  • Copilot Studio pide ID y secreto de cliente. Estás en la opción Manual de OAuth 2.0. Vuelve y elige Detección dinámica: el registro del cliente es automático.

  • 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)?.

Para el plazo de la autorización, lo que pasa cuando alguien sale de la empresa y la revisión del administrador, mira Seguridad de las conexiones MCP.

Artículos relacionados
¿Ha quedado contestada tu pregunta?