agentdocs-mcp

MCP-сервер для AgentDocs — платформы совместной работы с документацией, где AI-агенты — полноправные участники.

Предоставляет MCP-клиентам, которые запускают локальный сервер (Claude Code, Claude Desktop, Cursor, Windsurf, Zed, …), нативные инструменты для чтения, поиска, создания, обновления и публикации страниц AgentDocs.

Claude.ai (веб), Claude Desktop и Claude mobile подключаются вообще без токена: добавьте https://agentdocs.eu/mcp как пользовательский коннектор (Settings → Connectors → Add custom connector) и оставьте Advanced settings пустыми. AgentDocs реализует OAuth 2.1 — Claude автоматически обнаруживает поток, в вашем браузере открывается страница согласия AgentDocs, и после подтверждения вы подключены. Разрешение покрывает только ваши документы и может быть отозвано в любой момент на agentdocs.eu → Settings → Connected apps. Размещённый Skill остаётся запасным вариантом без коннектора, а Claude Desktop также может запустить локальную stdio-конфигурацию ниже.

Сервер указан в официальном реестре MCP как io.github.hoornet/agentdocs-mcp.

Setup

MCP-клиентам с коннектором (Claude.ai / Desktop / mobile) токен не нужен — см. примечание об OAuth выше. Для локального stdio-сервера и других клиентов нужен API-токен AgentDocs:

• Токен аккаунта — agentdocs.eu → Profile → Regenerate API Token (полный доступ ко всему, что вам принадлежит), или

• Токен пространства — Space settings → Tokens (доступ редактора ровно к одному пространству; сервер автоматически определяет это и ограничивает свою работу этим пространством — рекомендуемый способ изолировать агента).

Remote (hosted) — nothing to install

Любой клиент, поддерживающий удалённый MCP, может напрямую использовать размещённый эндпоинт; не нужно ничего устанавливать или обновлять. Те же 19 инструментов, что и у 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 (веб) и Claude Desktop используют один и тот же процесс: Settings → Connectors → Add custom connector, с заголовком запроса Authorization.

Это поле заголовка запроса — бета-функция Anthropic, включаемая для каждого аккаунта отдельно. Если в Advanced settings предлагаются только OAuth Client ID и OAuth Client Secret, то в вашем аккаунте этой функции нет — и эти поля OAuth здесь не сработают, потому что AgentDocs ещё не реализует OAuth (планируется). Коннектор просто сообщит об ошибке подключения.

В этом случае используйте Skill (Skills → Upload Skill): не нужен бета-доступ, тот же REST API, и это надёжный путь на Claude.ai сегодня.

Здесь принимаются как Bearer <api_token>, так и Token <api_token>, потому что некоторые клиенты предлагают только поле "Bearer". Работают и токены аккаунта, и токены пространства — токен пространства ограничивает сессию этим пространством, точно так же, как и через REST.

Claude Code (local 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

или в ~/.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 / generic MCP config

В claude_desktop_config.json / .cursor/mcp.json / ~/.codeium/windsurf/mcp_config.json / ~/.gemini/settings.json соответственно:

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

VS Code (Copilot)

Тот же блок сервера, но в .vscode/mcp.json используется ключ верхнего уровня "servers":

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

Zed

В settings.json:

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

Opencode

В opencode.json (в корне проекта) или ~/.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

Базовый pi поставляется без поддержки MCP — используйте там Skill или обычный REST API. Форк oh-my-pi (omp) поддерживает MCP и наследует серверы из уже существующих на диске конфигов (.claude, .cursor, .codex, .vscode, …) — добавьте стандартный блок mcpServers выше в один из них (например, .cursor/mcp.json) и перезапустите omp.

Windows

Многие MCP-клиенты не могут запустить npx напрямую в Windows (spawn npx ENOENT). Оберните команду в cmd /c:

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

MCP-шлюзы на основе каталога (например, Docker MCP gateway) запускают только серверы из своего курируемого каталога и не могут запускать произвольные npx-серверы — agentdocs-mcp там пока не значится. Вместо этого используйте размещённый удалённый эндпоинт: https://agentdocs.eu/mcp (Streamable HTTP, те же 19 инструментов, ничего устанавливать не нужно) — см. Remote выше. Если это не подходит, REST API полностью эквивалентен.

Configuration

Updating

Приведённые выше команды настройки не закреплены за версией (npx -y agentdocs-mcp), поэтому они всегда разрешают последнюю опубликованную версию. Чтобы получить новый выпуск, просто перезапустите ваш MCP-клиент — клиент запускает процесс сервера заново только при перезапуске. Сервер выводит свою версию при запуске (stderr): agentdocs-mcp vX.Y.Z: connected ….

Если npx отдаёт устаревшую копию из кэша, принудительно обновите:

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

Related MCP server: context-book

Tools

¹ Скрыты при работе с токеном пространства.

² path читает файл с машины, на которой запущен сервер, поэтому работает только на stdio-сервере. Размещённый эндпоинт agentdocs.eu/mcp отклоняет его — там «машиной» является производственный сервер AgentDocs, и выполнение пути, переданного вызывающей стороной, было бы произвольным чтением файлов. Используйте там source_url или data.

Страницы, пространства и рабочие пространства адресуются по UUID или человекочитаемому slug-пути — get_page принимает "my-workspace/my-space/my-page", create_page принимает "my-workspace/my-space" и т. д. (Для slug-путей требуется токен аккаунта.)

Notes

• Каждое обновление страницы создаёт версию на сервере; старые версии остаются восстановимыми в интерфейсе AgentDocs.

• Размещённый экземпляр может отвечать на первый запрос ~15 с после простоя (холодный старт базы данных) — сервер компенсирует это таймаутом 35 с и одной повторной попыткой.

• Лимиты API бесплатного тарифа отображаются понятными сообщениями со ссылкой на апгрейд.

Development

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

Тестовое пространство используется для записи (страницы создаются и удаляются) — используйте отдельное черновое пространство.

Security

См. SECURITY.md. Сообщайте об уязвимостях конфиденциально на contact@agentdocs.eu.

License

MIT