Conectar tu agente

Cómo conectar Claude Code, Codex, Cursor, VS Code, Windsurf, Claude y otros clientes al servidor MCP de Olimpia.

El servidor MCP de Olimpia está en:

https://api.olimpia.dev/mcp

Cualquier cliente que soporte servidores MCP remotos por HTTP se puede conectar. La primera vez, el cliente abre olimpia.dev para que autorices la conexión con tu sesión.

Por cliente

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

Después, dentro de Claude Code, corré /mcp, elegí olimpia y autorizá en el navegador.

También podés instalar el plugin de Olimpia, que trae el servidor y la skill juntos.

codex mcp add olimpia --url https://api.olimpia.dev/mcp

Codex abre el navegador para autorizar. Si no lo hace, corré codex mcp login olimpia.

Agregá esto en ~/.cursor/mcp.json (o en .cursor/mcp.json del proyecto):

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

Cursor muestra Needs login en Settings → MCP: tocalo para autorizar.

Agregá esto en .vscode/mcp.json:

{
  "servers": {
    "olimpia": { "type": "http", "url": "https://api.olimpia.dev/mcp" }
  }
}

Al iniciar el servidor, VS Code te pide autorizar en el navegador.

Agregá esto en ~/.codeium/windsurf/mcp_config.json:

{
  "mcpServers": {
    "olimpia": { "serverUrl": "https://api.olimpia.dev/mcp" }
  }
}

En Claude (web o escritorio), abrí Settings → Connectors → Add custom connector, poné Olimpia como nombre y https://api.olimpia.dev/mcp como URL, y autorizá.

Cualquier cliente MCP con soporte de servidores remotos:

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

Si tu cliente no soporta OAuth, usá un token personal.

Qué pasa al autorizar

El cliente descubre el servidor de autorización de Olimpia y se registra solo.
Se abre olimpia.dev con una pantalla de consentimiento que dice qué agente pide acceso.
Si aprobás, el cliente recibe un token de acceso que dura una hora y se renueva solo.

Ves y revocás cada agente conectado en Cuenta → Agentes y tokens.

En una máquina remota

Si tu agente corre en un servidor por SSH, un contenedor o un devcontainer, no puede abrir tu navegador. Con Claude Code:

claude mcp login olimpia --no-browser

Abrí la URL que imprime en tu computadora, aprobá, copiá el código de conexión que te muestra Olimpia y pegalo donde Claude Code pide la URL de retorno.

Con el plugin de Olimpia, el agente te da un enlace y te pide un código de 8 caracteres: lo abrís en cualquier dispositivo, autorizás y le pasás el código.

Probar la conexión

Pedile al agente: “¿Qué proyectos tengo en Olimpia?”. Debería llamar a list_projects y mostrarte tus proyectos.