anytype-mcp

anytype-mcp — MCP-сервер сообщества (автор — anyproto). Официальный сервер Anytype: зашифрованная локальная вики для совместной работы. Ставится через npx. Лицензия MIT.

Опубликовано 13.11.2026 · Обновлено 14.11.2026 · Проверено 13.11.2026

Кратко о сервере

Разработчик
anyproto
Лицензия
MIT
Транспорт
stdio
Авторизация
api_key
ОС
Не указана
Языки
typescript

Уровень риска: high

Чтение, создание, изменение и удаление объектов Anytype; expected_etag и dry_run; файлы скачиваются во временную папку.

Настройка клиентов

claude-code
{
    "code": "claude mcp add anytype -e OPENAPI_MCP_HEADERS='{\"Authorization\":\"Bearer <YOUR_API_KEY>\", \"Anytype-Version\":\"2025-11-08\"}' -s user -- npx -y @anyproto/anytype-mcp",
    "lang": "bash",
    "notes": "Дословно из README",
    "verified": "docs"
}

Что умеет

Anytype MCP Server — официальный MCP-сервер для API приложения Anytype. Ассистент работает с вашей базой знаний Anytype обычными словами. Сервер превращает OpenAPI-спецификацию Anytype в MCP-инструменты.

Возможности:

  • глобальный поиск и поиск внутри пространства;
  • пространства и участники;
  • объекты и списки (коллекции);
  • свойства и теги;
  • типы и шаблоны;
  • скачивание файлов: байты сохраняются во временную папку на машине, где работает MCP.

Особенности по README:

  • при запуске сервер загружает спецификацию API v2, а если её нет — откатывается на прежнюю спецификацию. После обновления Anytype перезапустите MCP, чтобы подхватить новую версию API;
  • защита от перезаписи: expected_etag передаётся как If-Match, поэтому изменённый кем-то объект не будет затёрт;
  • идемпотентность записей: request_key передаётся как Idempotency-Key;
  • доступны dry_run, постраничный вывод и выбор полей;
  • управление парами устройств и API-ключами исключено. Инструмент auth_whoami (v2) показывает права текущего ключа, но не сам токен;
  • ANYTYPE_MCP_DEBUG=1 выводит в stderr названия операций, статусы и время без аргументов и заголовков авторизации.

Кому подойдёт

  • Пользователям Anytype, которые хотят создавать задачи, заметки и коллекции голосом ассистента.
  • Тем, кто ведёт базу знаний и ищет по ней из Claude, Cursor и других клиентов.

Похожие серверы — в категории знания и память.

Установка

  1. Откройте Anytype → App Settings → API Keys и нажмите Create new. Ключ можно получить и из командной строки: npx -y @anyproto/anytype-mcp get-key.
  2. Добавьте конфиг в клиент (ниже). Пакет запускается через npx, отдельная установка не нужна. Есть и глобальная установка: npm install -g @anyproto/anytype-mcp.

По умолчанию сервер подключается к локальному API Anytype на http://127.0.0.1:31009. Для anytype-cli (порт 31012) или другого адреса задайте ANYTYPE_API_BASE_URL.

Подключение к клиентам

Конфиги приведены дословно из README. Вставьте в них свой ключ. Подробнее — в инструкции как подключить MCP.

{
  "mcpServers": {
    "anytype": {
      "command": "npx",
      "args": ["-y", "@anyproto/anytype-mcp"],
      "env": {
        "OPENAPI_MCP_HEADERS": "{\"Authorization\":\"Bearer <YOUR_API_KEY>\", \"Anytype-Version\":\"2025-11-08\"}"
      }
    }
  }
}

Тот же JSON подходит для Cursor, Windsurf, Raycast и других клиентов. После создания ключа Anytype сам показывает готовый фрагмент конфига с подставленным ключом. Для Cursor, LM Studio и Kiro есть кнопки установки.

Проверка

Anytype должен быть запущен. Попросите ассистента показать ваши пространства или вызвать auth_whoami, чтобы увидеть права ключа. Ошибки API возвращаются с isError: true, HTTP-статусом и подсказками.

Примеры задач

Создай пространство «Идеи проектов» с описанием «Место для идей».
Добавь задачу «Изучить тренды ИИ» со сроком через три дня и включи её в коллекцию «Задачи на неделю».

Риски

Ассистент получает доступ к вашей базе знаний Anytype: может читать, создавать, изменять и удалять объекты, пространства и коллекции. Меры:

  • для правок используйте expected_etag, чтобы не затереть изменения, сделанные параллельно;
  • для проверки без записи есть dry_run. Удаления подтверждайте вручную;
  • API-ключ даёт доступ к данным. Храните его в конфиге клиента, не коммитьте и не публикуйте. Отозвать ключ можно в настройках Anytype;
  • скачанные файлы сохраняются во временную папку на машине, где работает MCP.

Частые вопросы

Работает ли сервер без запущенного Anytype?

Нет, он обращается к локальному API Anytype. Приложение или anytype-cli должны быть запущены.

Какая версия API используется?

По умолчанию v2, с откатом на прежнюю спецификацию. Версию v1 можно выбрать явно через URL спецификации.

Основы протокола — на странице что такое MCP-сервер.

Похожие MCP-серверы

Memory

Эталонный сервер постоянной памяти на основе графа знаний.

Риск: high Лицензия: NOASSERTION ★ 92 089

Context7

Context7 даёт агентам актуальную документацию и примеры кода библиотек нужных версий.

Риск: medium Лицензия: MIT ★ 65 087

hindsight

Долговременная память для ИИ-агентов по образцу человеческой.

Риск: medium Лицензия: MIT ★ 61 836

cognee-mcp

Менеджер памяти cognee для ИИ-приложений на графовых и векторных хранилищах.

Риск: high Лицензия: Apache-2.0 ★ 33 236

Источники