agentdocs-mcp

MCP-Server für AgentDocs – die kollaborative Dokumentationsplattform, auf der KI-Agenten erstklassige Bürger sind.

Bietet MCP-Clients, die einen lokalen Server ausführen (Claude Code, Claude Desktop, Cursor, Windsurf, Zed, …) native Werkzeuge zum Lesen, Durchsuchen, Erstellen, Aktualisieren und Teilen von AgentDocs-Seiten.

Claude.ai (Web), Claude Desktop und Claude Mobile verbinden sich ganz ohne Token: fügen Sie https://agentdocs.eu/mcp als benutzerdefinierten Connector hinzu (Einstellungen → Connectors → Benutzerdefinierten Connector hinzufügen) und lassen Sie „Erweitert“ leer. AgentDocs implementiert OAuth 2.1 – Claude erkennt den Ablauf automatisch, Ihr Browser öffnet eine AgentDocs-Zustimmungsseite, und Sie sind nach der Genehmigung verbunden. Die Berechtigung umfasst nur Ihre Dokumente und kann jederzeit unter agentdocs.eu → Einstellungen → Verbundene Apps widerrufen werden. Die gehostete Skill bleibt ein Connector-freier Fallback, und Claude Desktop kann auch das lokale stdio-Setup weiter unten ausführen.

Im offiziellen MCP-Register gelistet als io.github.hoornet/agentdocs-mcp.

Einrichtung

MCP-Connector-Clients (Claude.ai / Desktop / Mobile) benötigen kein Token – siehe den OAuth-Hinweis oben. Für den lokalen stdio-Server und andere Clients benötigen Sie ein AgentDocs-API-Token:

• Konto-Token – agentdocs.eu → Profil → API-Token neu generieren (voller Zugriff auf alles, was Ihnen gehört), oder

• Space-Token – Space-Einstellungen → Token (Bearbeiterzugriff auf genau einen Space; der Server erkennt dies automatisch und beschränkt sich auf diesen Space – die empfohlene Methode, um einen Agenten zu sandboxen).

Remote (gehostet) – nichts zu installieren

Jeder Client, der Remote-MCP spricht, kann den gehosteten Endpunkt direkt verwenden; es gibt kein Paket zu installieren und nichts aktuell zu halten. Gleiche 19 Werkzeuge wie der stdio-Server.

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) und Claude Desktop verwenden denselben Ablauf: Einstellungen → Connectors → Benutzerdefinierten Connector hinzufügen, mit einem Authorization-Anfrageheader.

Dieses Anfrageheader-Feld ist eine Anthropic-Beta, die pro Konto aktiviert wird. Wenn Erweiterte Einstellungen nur OAuth-Client-ID und OAuth-Client-Geheimnis anbieten, hat Ihr Konto sie nicht – und diese OAuth-Felder funktionieren hier nicht, weil AgentDocs OAuth noch nicht implementiert (geplant). Der Connector meldet dann einfach einen Verbindungsfehler.

Verwenden Sie in diesem Fall die Skill (Skills → Skill hochladen): kein Beta-Zugang nötig, dieselbe REST-API, und der zuverlässige Weg auf Claude.ai heute.

Bearer <api_token> wird hier ebenso akzeptiert wie Token <api_token>, da einige Clients nur ein „Bearer“-Feld anbieten. Konto-Token und Space-Token funktionieren beide – ein Space-Token beschränkt die Sitzung auf seinen eigenen Space, genau wie über REST.

Claude Code (lokales stdio)

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

oder in ~/.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 / generische MCP-Konfiguration

In claude_desktop_config.json / .cursor/mcp.json / ~/.codeium/windsurf/mcp_config.json / ~/.gemini/settings.json bzw.:

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

VS Code (Copilot)

Gleicher Serverblock, aber .vscode/mcp.json verwendet einen "servers"-Schlüssel auf oberster Ebene:

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

Zed

In settings.json:

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

Opencode

In opencode.json (Projektstamm) oder ~/.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

Das Basis-pi wird ohne MCP-Unterstützung ausgeliefert – verwenden Sie dort die Skill oder die einfache REST-API. Der oh-my-pi (omp)-Fork unterstützt MCP und erbt Server aus bereits vorhandenen Konfigurationen auf der Platte (.claude, .cursor, .codex, .vscode, …) – fügen Sie den Standard-mcpServers-Block oben zu einer davon hinzu (z. B. .cursor/mcp.json) und starten Sie omp neu.

Windows

Viele MCP-Clients können npx unter Windows nicht direkt ausführen (spawn npx ENOENT). Umgeben Sie den Befehl mit cmd /c:

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

Katalogbasierte MCP-Gateways (z. B. das Docker-MCP-Gateway) führen nur Server aus ihrem kuratierten Katalog aus und können keine beliebigen npx-Server starten – agentdocs-mcp ist dort noch nicht gelistet. Verwenden Sie stattdessen den gehosteten Remote-Endpunkt: https://agentdocs.eu/mcp (Streamable HTTP, gleiche 19 Werkzeuge, nichts zu installieren) – siehe Remote oben. Falls das nicht klappt, bietet die REST-API volle Parität.

Konfiguration

Aktualisierung

Die Einrichtungsbefehle oben sind nicht versioniert (npx -y agentdocs-mcp), sodass sie immer die neueste veröffentlichte Version auflösen. Für ein neues Release starten Sie einfach Ihren MCP-Client neu – der Client startet den Serverprozess beim Neustart neu. Der Server gibt seine Version beim Start auf stderr aus: agentdocs-mcp vX.Y.Z: connected ….

Wenn npx eine veraltete Kopie im Cache bedient, erzwingen Sie eine Aktualisierung:

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

Related MCP server: context-book

Werkzeuge

¹ Ausgeblendet bei Verwendung eines Space-bezogenen Tokens.

² path liest eine Datei von dem Rechner, auf dem dieser Server läuft, funktioniert also nur auf dem stdio-Server. Der gehostete agentdocs.eu/mcp-Endpunkt lehnt ihn ab – dort ist der „Rechner“ AgentDocs' Produktionsserver, und das Befolgen eines vom Aufrufer gelieferten Pfads wäre ein beliebiger Dateizugriff. Verwenden Sie dort source_url oder data.

Seiten, Spaces und Workspaces sind per UUID oder menschenlesbarem Slug-Pfad adressierbar – get_page akzeptiert "my-workspace/my-space/my-page", create_page akzeptiert "my-workspace/my-space" usw. (Slug-Pfade erfordern ein Konto-Token.)

Hinweise

• Jede Seitenaktualisierung erstellt eine Version auf dem Server; alte Versionen bleiben über die AgentDocs-Oberfläche wiederherstellbar.

• Die gehostete Instanz kann ~15 s brauchen, um auf die erste Anfrage nach einer Ruhephase zu antworten (Kaltstart der Datenbank) – der Server fängt dies mit einem 35-s-Timeout und einem Wiederholungsversuch ab.

• API-Limits der kostenlosen Stufe erscheinen als klare Meldungen mit einem Upgrade-Link.

Entwicklung

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

Der Test-Space wird beschrieben (Seiten werden erstellt und gelöscht) – verwenden Sie einen Wegwerf-Space.

Sicherheit

Siehe SECURITY.md. Melden Sie Schwachstellen vertraulich an contact@agentdocs.eu.

Lizenz

MIT