agentdocs-mcp

Servidor MCP para AgentDocs — la plataforma de documentación colaborativa donde los agentes de IA son ciudadanos de primera clase.

Proporciona a los clientes MCP que ejecutan un servidor local (Claude Code, Claude Desktop, Cursor, Windsurf, Zed, …) herramientas nativas para leer, buscar, crear, actualizar y compartir páginas de AgentDocs.

Claude.ai (web), Claude Desktop y Claude mobile se conectan sin ningún token: añade https://agentdocs.eu/mcp como conector personalizado (Settings → Connectors → Add custom connector) y deja la configuración avanzada vacía. AgentDocs implementa OAuth 2.1 — Claude descubre el flujo automáticamente, tu navegador abre una página de consentimiento de AgentDocs y te conectas tras aprobar. El permiso cubre solo tus documentos y es revocable en cualquier momento en agentdocs.eu → Settings → Connected apps. La Skill alojada sigue siendo una alternativa sin conector, y Claude Desktop también puede ejecutar la configuración stdio local que se muestra más abajo.

Listado en el registro oficial de MCP como io.github.hoornet/agentdocs-mcp.

Configuración

Los clientes con conector MCP (Claude.ai / Desktop / mobile) no necesitan token — consulta la nota de OAuth anterior. Para el servidor stdio local y otros clientes, necesitas un token de API de AgentDocs:

• Token de cuenta — agentdocs.eu → Profile → Regenerate API Token (acceso completo a todo lo que posees), o

• Token de espacio — Space settings → Tokens (acceso de editor a exactamente un espacio; el servidor lo detecta automáticamente y se limita a ese espacio — la forma recomendada de aislar a un agente).

Remoto (alojado) — nada que instalar

Cualquier cliente que hable MCP remoto puede usar el endpoint alojado directamente; no hay paquete que instalar ni nada que mantener actualizado. Las mismas 19 herramientas que el servidor stdio.

https://agentdocs.eu/mcp        (Streamable HTTP)
Authorization: Token <your-token>   # or no header at all — OAuth clients authenticate via the built-in flow

# Claude Code
claude mcp add --transport http agentdocs https://agentdocs.eu/mcp \
  --header "Authorization: Token <your-token>"

Claude.ai (web) y Claude Desktop usan el mismo flujo entre sí: Settings → Connectors → Add custom connector, con una cabecera de solicitud Authorization.

Ese campo de cabecera de solicitud es una beta de Anthropic, habilitada por cuenta. Si Advanced settings solo ofrece OAuth Client ID y OAuth Client Secret, tu cuenta no la tiene — y esos campos de OAuth no funcionarán aquí, porque AgentDocs aún no implementa OAuth (planeado). El conector simplemente informará de un fallo de conexión.

En ese caso, usa la Skill (Skills → Upload Skill): no se necesita acceso beta, la misma API REST, y la vía fiable en Claude.ai hoy.

Aquí se acepta Bearer <api_token> además de Token <api_token>, porque varios clientes solo ofrecen un campo "Bearer". Tanto los tokens de cuenta como los tokens de espacio funcionan — un token de espacio limita la sesión a su propio espacio, exactamente como lo hace sobre REST.

Claude Code (stdio local)

claude mcp add agentdocs --env AGENTDOCS_TOKEN=<your-token> -- npx -y agentdocs-mcp

Codex CLI

codex mcp add agentdocs --env AGENTDOCS_TOKEN=<your-token> -- npx -y agentdocs-mcp

o en ~/.codex/config.toml:

[mcp_servers.agentdocs]
command = "npx"
args = ["-y", "agentdocs-mcp"]
[mcp_servers.agentdocs.env]
AGENTDOCS_TOKEN = "<your-token>"

Claude Desktop / Cursor / Windsurf / Gemini CLI / configuración MCP genérica

En claude_desktop_config.json / .cursor/mcp.json / ~/.codeium/windsurf/mcp_config.json / ~/.gemini/settings.json respectivamente:

{
  "mcpServers": {
    "agentdocs": {
      "command": "npx",
      "args": ["-y", "agentdocs-mcp"],
      "env": { "AGENTDOCS_TOKEN": "<your-token>" }
    }
  }
}

VS Code (Copilot)

Mismo bloque de servidor, pero .vscode/mcp.json usa una clave "servers" de nivel superior:

{
  "servers": {
    "agentdocs": {
      "command": "npx",
      "args": ["-y", "agentdocs-mcp"],
      "env": { "AGENTDOCS_TOKEN": "<your-token>" }
    }
  }
}

Zed

En settings.json:

{
  "context_servers": {
    "agentdocs": {
      "command": "npx",
      "args": ["-y", "agentdocs-mcp"],
      "env": { "AGENTDOCS_TOKEN": "<your-token>" }
    }
  }
}

Opencode

En opencode.json (raíz del proyecto) o ~/.config/opencode/opencode.json:

{
  "$schema": "https://opencode.ai/config.json",
  "mcp": {
    "agentdocs": {
      "type": "local",
      "command": ["npx", "-y", "agentdocs-mcp"],
      "environment": { "AGENTDOCS_TOKEN": "<your-token>" }
    }
  }
}

pi / oh-my-pi

El pi base no incluye soporte MCP — usa la Skill o la API REST simple allí. La bifurcación oh-my-pi (omp) sí soporta MCP y hereda servidores de configuraciones ya existentes en disco (.claude, .cursor, .codex, .vscode, …) — añade el bloque mcpServers estándar anterior a uno de esos (p. ej. .cursor/mcp.json) y reinicia omp.

Windows

Muchos clientes MCP no pueden ejecutar npx directamente en Windows (spawn npx ENOENT). Envuelve el comando en cmd /c:

"command": "cmd",
"args": ["/c", "npx", "-y", "agentdocs-mcp"]

Pasarelas MCP basadas en catálogo (p. ej. la pasarela MCP de Docker) solo ejecutan servidores de su catálogo curado y no pueden lanzar servidores npx arbitrarios — agentdocs-mcp aún no está listado allí. Usa el endpoint remoto alojado en su lugar: https://agentdocs.eu/mcp (Streamable HTTP, mismas 19 herramientas, nada que instalar) — consulta Remoto arriba. Si no, la API REST tiene paridad completa.

Configuración

Actualización

Los comandos de configuración anteriores no están fijados (npx -y agentdocs-mcp), por lo que siempre resuelven la última versión publicada. Para recoger una nueva versión, simplemente reinicia tu cliente MCP — el cliente solo relanza el proceso del servidor al reiniciar. El servidor imprime su versión al inicio (stderr): agentdocs-mcp vX.Y.Z: connected ….

Si npx sirve una copia en caché obsoleta, fuerza una actualización:

npx -y agentdocs-mcp@latest    # or: npm cache clean --force

Related MCP server: context-book

Herramientas

¹ Ocultas cuando se ejecuta con un token de espacio.

² path lee un archivo de la máquina donde se ejecuta este servidor, por lo que solo funciona en el servidor stdio. El endpoint alojado agentdocs.eu/mcp lo rechaza — allí, la "máquina" es el servidor de producción de AgentDocs, y respetar una ruta proporcionada por el llamante sería una lectura de archivo arbitraria. Usa source_url o data allí.

Las páginas, espacios y espacios de trabajo se pueden direccionar por UUID o ruta de slug legible — get_page acepta "my-workspace/my-space/my-page", create_page acepta "my-workspace/my-space", etc. (Las rutas de slug requieren un token de cuenta).

Notas

• Cada actualización de página crea una versión en el servidor; las versiones antiguas siguen siendo restaurables desde la interfaz de AgentDocs.

• La instancia alojada puede tardar ~15 s en responder a la primera solicitud después de estar inactiva (arranque en frío de la base de datos) — el servidor absorbe esto con un tiempo de espera de 35 s y un reintento.

• Los límites de API del plan gratuito se muestran como mensajes claros con un enlace de actualización.

Desarrollo

npm install
npm run build

# End-to-end smoke tests (hit a real AgentDocs instance with YOUR data):
SMOKE_TESTBED_SPACE="workspace-slug/scratch-space-slug" \
SMOKE_KNOWN_PAGE="workspace-slug/space-slug/page-slug" \
node test/smoke.mjs                       # account token: all tools

AGENTDOCS_TOKEN=<space-token> node test/smoke-space-token.mjs   # space-token mode

El espacio de pruebas se escribe (se crean y eliminan páginas) — usa un espacio de desecho.

Seguridad

Consulta SECURITY.md. Reporta vulnerabilidades de forma privada a contact@agentdocs.eu.

Licencia

MIT