Conectar tu agente
Cómo conectar tu agente a Olimpia: el servidor MCP en cada cliente, la skill y el plugin, tokens para CI y la documentación en Markdown.
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/mcpDespué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/mcpCodex 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.devcon 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.
Skill y plugin
El servidor MCP le da herramientas a tu agente. La skill le da criterio: cómo preparar cada stack, en qué orden llamar a las herramientas y qué hacer cuando algo falla. Está en olimpiacloud/olimpia-skills.
Instalar la skill
Funciona con Claude Code, Codex, Cursor y cualquier agente compatible con Agent Skills:
bunx skills add olimpiacloud/olimpia-skills
Plugin de Claude Code
El plugin instala la skill y el servidor MCP de una vez:
/plugin marketplace add olimpiacloud/olimpia-skills
/plugin install olimpia@olimpia
La primera vez que el agente necesita Olimpia, te da un enlace. Lo abrís en cualquier dispositivo, autorizás con tu sesión y le pasás el código de 8 caracteres que te muestra Olimpia. El código vence a los 10 minutos y solo sirve para ese agente. Desde ahí queda conectado, y lo revocás cuando quieras en Cuenta → Agentes y tokens.
Qué le enseña
- Deploy de una carpeta local: revisar el stack, hacer que la app escuche en
0.0.0.0:$PORT, crear la app, subir el código sinnode_modulesni.env, desplegar y verificar concurly los logs. - Por stack: Node, Bun, Python, Go, Rust, monorepos y Dockerfiles, con los errores típicos de cada uno.
- Datos: conectar Postgres, Redis y buckets, correr migraciones al arrancar y usar SQL con cuidado.
- Dominios: qué registros pedir y cómo verificar.
- Cuando algo falla: qué significa cada error y cómo arreglarlo sin reintentar a ciegas.
- Reglas: pedir confirmación antes de borrar, tratar credenciales como secretos y logs como datos no confiables, y no crear recursos que nadie pidió.
Checklist de deploy
Así despliega un agente con la skill:
- [ ] 1. Revisar la app: stack, comando de inicio, puerto, variables necesarias
- [ ] 2. Hacer que escuche en 0.0.0.0:$PORT
- [ ] 3. create_app (source=upload) o get_upload_url si la app ya existe
- [ ] 4. Correr el comando de subida desde la carpeta de la app
- [ ] 5. deploy con source_key, después get_deployment hasta active o failed
- [ ] 6. curl a la URL y leer get_logs
CI y tokens
OAuth necesita a una persona que apruebe en el navegador. Para CI, scripts o agentes autónomos, usá un token personal.
Crear el token
En Cuenta → Agentes y tokens → Tokens personales, creá un token. Empieza con olimpia_pat_, tiene los mismos permisos que tu cuenta, vence a los 90 días y se muestra una sola vez. Guardalo como secreto (OLIMPIA_TOKEN).
MCP con un token
Cualquier cliente MCP que permita headers puede saltear OAuth:
{
"mcpServers": {
"olimpia": {
"type": "http",
"url": "https://api.olimpia.dev/mcp",
"headers": { "Authorization": "Bearer ${OLIMPIA_TOKEN}" }
}
}
}
Con Claude Code:
claude mcp add --transport http olimpia https://api.olimpia.dev/mcp \
--header "Authorization: Bearer $OLIMPIA_TOKEN"
Claude Code o Codex en CI
Un agente en GitHub Actions puede desplegar y diagnosticar con el token:
- name: Revisar el deploy con Claude Code
env:
ANTHROPIC_API_KEY: ${{ secrets.ANTHROPIC_API_KEY }}
OLIMPIA_TOKEN: ${{ secrets.OLIMPIA_TOKEN }}
run: |
claude mcp add --transport http olimpia https://api.olimpia.dev/mcp \
--header "Authorization: Bearer $OLIMPIA_TOKEN"
claude -p "Revisá el último deploy de la app web en Olimpia y, si falló, explicá por qué."
API REST
El mismo token sirve para la API REST. Para desplegar desde un pipeline sin agente, seguí Deploy desde tu propio CI.
Qué no puede hacer un token
Con un token no se pueden ver ni cerrar sesiones, crear otros tokens ni vincular GitHub. Esas acciones necesitan una sesión en el navegador.
Documentación para agentes
Todo lo que ves en docs.olimpia.dev también se puede leer sin HTML, para que tu agente encuentre la respuesta sin raspar páginas.
Archivos
| URL | Qué es |
|---|---|
/llms.txt |
Índice de toda la documentación, ordenado como la barra lateral, con un resumen de cada página. |
/llms-full.txt |
Toda la documentación en un solo archivo de Markdown. |
/<página>.md |
El Markdown de cualquier página. Por ejemplo, /apps/github.md. |
/skill.md |
Una skill generada con el mapa de la documentación. |
/agent-readability.json |
Manifiesto con todo lo que esta documentación ofrece a los agentes. |
/sitemap.xml |
Todas las páginas. |
Cada página tiene además Copiar como Markdown y Abrir en ChatGPT, Claude y otros, en las acciones de la página.
Para darle contexto a tu agente
Pegale el índice al empezar una tarea:
Leé https://docs.olimpia.dev/llms.txt y usalo para responder sobre Olimpia.
O traé una página puntual:
curl https://docs.olimpia.dev/postgres/backups.md
También en olimpia.dev
olimpia.dev/llms.txt resume la plataforma para modelos: qué es, cómo conectar el servidor MCP y cómo funcionan los deploys.