Conectar un servidor MCP a Claude y a Claude Code

Un servidor MCP le da a Claude herramientas nuevas: buscar en tu Notion, leer issues de GitHub o consultar el modelo de datos de tu proyecto CAP. En 10 minutos vas a conectar uno en la app de Claude (donde se llaman conectores) y otro en Claude Code con claude mcp add, y sabrás elegir bien el ámbito y qué revisar antes de dar acceso.

Antes de empezar

• Una cuenta de Claude. Los conectores personalizados funcionan en todos los planes (en el gratuito, con un solo conector personalizado); en Team y Enterprise solo los propietarios pueden añadirlos a la organización.
• Para la parte de Claude Code, tenerlo instalado y con sesión iniciada.
• Para el ejemplo SAP, Node.js instalado (el servidor se lanza con npx).
• Saber qué es MCP a grandes rasgos. Si no, la lección MCP: el enchufe universal lo cuenta.

1. En la app de Claude: conectores

La app trae un directorio de conectores revisados (Google Drive, Notion, Slack y muchos más) y permite añadir cualquier servidor MCP remoto por URL.

Un detalle importante: los conectores remotos se conectan desde la nube de Anthropic, no desde tu ordenador. Un servidor que solo existe en la red interna de tu empresa o detrás de la VPN no será accesible salvo que tu equipo de sistemas lo exponga de forma controlada.

2. En Claude Code: claude mcp add

En Claude Code puedes conectar dos tipos de servidores: remotos (una URL, transporte HTTP) y locales (un programa que se ejecuta en tu máquina, transporte stdio). Vamos con un ejemplo de cada, ambos oficiales:

• Notion, servidor remoto oficial de Notion.
• cds-mcp, el servidor oficial de SAP para proyectos CAP (paquete @cap-js/mcp-server). Ofrece dos herramientas: search_model, que busca entidades, servicios y endpoints en el modelo CDS de tu proyecto, y search_docs, que busca en la documentación de CAP.

# Remoto por HTTP (oficial de Notion)
$ claude mcp add --transport http notion https://mcp.notion.com/mcp
# Local por stdio (oficial de SAP para CAP), desde la raíz de tu proyecto CAP
$ claude mcp add cds-mcp -- npx -y @cap-js/mcp-server
# Ver todos los servidores y su estado (salida resumida)
$ claude mcp list
notion … ! Needs authentication
cds-mcp … ✔ Connected
# Dentro de la sesión, /mcp para iniciar sesión en Notion (OAuth)
$ /mcp

Con el servidor de CAP conectado, pregunta cosas como «¿qué servicios CDS hay en este proyecto y dónde se sirven?». Claude consultará el modelo con search_model en lugar de leerse todos los .cds. Ojo: este servidor trabaja con tu proyecto local y la documentación, no se conecta a ningún sistema SAP. Si lo que quieres es que Claude acceda a datos de un SAP, hazlo por vías oficiales (BTP, APIs publicadas); lo explicamos en Claude y SAP y en Conexiones.

Y un atajo: si inicias sesión en Claude Code con tu cuenta de claude.ai, los conectores que ya tienes en la app aparecen automáticamente en /mcp, marcados como procedentes de claude.ai.

3. Elige bien el ámbito

Cada claude mcp add guarda el servidor en uno de tres ámbitos, con --scope:

La regla práctica: project para lo que todo el equipo necesita en ese repositorio (el cds-mcp en un proyecto CAP encaja perfecto), user para tus herramientas personales de uso diario y local para pruebas o servidores con credenciales tuyas. Por seguridad, la primera vez que abres un proyecto con .mcp.json, Claude Code te pide aprobar esos servidores antes de usarlos.

Si algo falla

• El servidor sale como «Needs authentication»: abre /mcp en la sesión, selecciónalo y completa el inicio de sesión. Si caduca, ahí mismo tienes Re-authenticate.
• Sale «Failed to connect»: en servidores stdio, prueba el comando a mano (por ejemplo npx -y @cap-js/mcp-server) para ver el error; suele faltar Node.js o una variable de entorno. En remotos, revisa la URL y el token.
• Un servidor de .mcp.json se queda en «Pending approval»: abre claude en esa carpeta y acepta el diálogo de confianza y la aprobación del servidor.
• En la app, un conector propio no conecta: comprueba que la URL es accesible desde internet; la conexión sale de la nube de Anthropic, no de tu red.