Conectá tu agente

Agregá el servidor MCP de Agora a Claude Code, Codex o cualquier cliente MCP, instalá la skill de Agora y leé esta documentación como Markdown.

Los agentes se comunican con Agora mediante agora mcp, un servidor MCP por stdio que reenvía cada llamada a herramienta a la API HTTP del daemon. Corrélo en la misma máquina que el daemon.

Antes de empezar

Agora tiene que estar instalado y corriendo (instalación). Verificalo:

agora api GET /v1/health

{"ok":true,...} significa que el daemon está levantado.

Conseguí un token de cursor

Dale a cada agente su propio token de cursor. Con un token de cursor, el servidor sabe quién es el agente y en qué workspace trabaja, así que las herramientas no piden un argumento workspace y el agente solo puede acceder a su propio workspace.

WS=$(agora api POST /v1/workspaces '{"name":"main"}' | jq -r .id)
agora api POST /v1/cursors "{\"name\":\"claude\",\"workspace\":\"$WS\"}" | jq -r .token

El token se muestra una sola vez; Agora guarda solo un hash. Para limitar lo que puede hacer el agente, agregá "permissions" (mirá seguridad).

Claude Code

claude mcp add agora -e AGORA_TOKEN=<cursor token> -- agora mcp

O instalá el plugin de Claude Code, que incluye la skill y el servidor MCP:

/plugin marketplace add olimpiacloud/agora-skills
/plugin install agora@agora

Codex

codex mcp add agora --env AGORA_TOKEN=<cursor token> -- agora mcp

Cualquier cliente MCP

Cursor, VS Code, Windsurf y otros clientes con configuración en JSON:

{
  "mcpServers": {
    "agora": {
      "command": "agora",
      "args": ["mcp"],
      "env": { "AGORA_TOKEN": "<cursor token>" }
    }
  }
}

Reiniciá la sesión del agente después de agregar el servidor para que se carguen las herramientas.

Variables de entorno

Una configuración liviana para un agente que solo navega y lanza subagentes:

claude mcp add agora -e AGORA_TOKEN=<cursor token> -e AGORA_TOOLS=browser,spawn -e AGORA_LEAN=1 -- agora mcp

Si el agente corre en otra máquina, corré agora mcp ahí y apuntá AGORA_URL a un túnel autenticado hacia el daemon. Nunca abras el puerto 7788 a internet.

Paseo

Con el plugin de Paseo, cada agente de Claude o Codex en Paseo recibe automáticamente el servidor MCP de Agora y su propio cursor. No necesitás correr los comandos de arriba.

Subagentes lanzados por Agora

Los agentes que Agora inicia con cursor_spawn y launch ya tienen el servidor MCP configurado con su propio token acotado. Mirá subagentes.

La skill de Agora

La skill les enseña a los agentes a trabajar con Agora: actuar y leer la observación que vuelve, usar refs en lugar de coordenadas, lanzar subagentes y esperarlos, y pedir un humano ante los CAPTCHAs.

bunx skills add olimpiacloud/agora-skills

Funciona con Claude Code, Codex, Cursor y otros agentes que soportan skills. Sacala con bunx skills remove agora. El código fuente está en github.com/olimpiacloud/agora-skills.

Documentación para agentes

Esta documentación también se publica en formatos que los agentes pueden leer directamente: