Anytype MCP Server
Официальный MCP сервер Anytype: агент ищет, создает и меняет объекты, списки и типы в вашей базе знаний
Средний риск
Средний уровень ставим, когда инструмент запускает код, ходит в сеть или читает файлы проекта. Перед установкой посмотрите, что именно он делает.
Почему такой уровень
- Создает, меняет и удаляет объекты в вашей базе знаний Anytype
- Работает с ключом API, который передается в заголовке Authorization
Установка
В терминале, через SkillFoxx CLI
npx skillfoxx add mcp/anytype-mcp-serverОпределит агенты на машине, проверит риск и зафиксирует версию.
Другие способы установки
Выполните в терминале
claude mcp add --transport stdio --env 'OPENAPI_MCP_HEADERS=<ваш OPENAPI_MCP_HEADERS>' anytype -- npx -y @anyproto/anytype-mcpИли добавьте в файл .mcp.json, в проекте
{
"mcpServers": {
"anytype": {
"command": "npx",
"args": [
"-y",
"@anyproto/anytype-mcp"
],
"env": {
"OPENAPI_MCP_HEADERS": "<ваш OPENAPI_MCP_HEADERS>"
}
}
}
}Если файл уже есть, добавьте сервер внутрь ключа mcpServers.
Ключи и настройки
OPENAPI_MCP_HEADERSсекрет, обязательная
Замените значения в угловых скобках своими. Ключи не попадают в ссылки установки и не хранятся у нас.
Кнопка откроет агент и предложит добавить сервер. Если ничего не произошло, скопируйте конфиг ниже.
Добавьте в файл ~/.cursor/mcp.json, для всех проектов
{
"mcpServers": {
"anytype": {
"command": "npx",
"args": [
"-y",
"@anyproto/anytype-mcp"
],
"env": {
"OPENAPI_MCP_HEADERS": "<ваш OPENAPI_MCP_HEADERS>"
}
}
}
}Если файл уже есть, добавьте сервер внутрь ключа mcpServers. Для одного проекта тот же блок кладут в .cursor/mcp.json.
Ключи и настройки
OPENAPI_MCP_HEADERSсекрет, обязательная
Замените значения в угловых скобках своими. Ключи не попадают в ссылки установки и не хранятся у нас.
Кнопка откроет агент и предложит добавить сервер. Если ничего не произошло, скопируйте конфиг ниже.
Выполните в терминале
code --add-mcp '{"name":"anytype","type":"stdio","command":"npx","args":["-y","@anyproto/anytype-mcp"],"env":{"OPENAPI_MCP_HEADERS":"<ваш OPENAPI_MCP_HEADERS>"}}'Или добавьте в файл .vscode/mcp.json, в проекте
{
"servers": {
"anytype": {
"type": "stdio",
"command": "npx",
"args": [
"-y",
"@anyproto/anytype-mcp"
],
"env": {
"OPENAPI_MCP_HEADERS": "<ваш OPENAPI_MCP_HEADERS>"
}
}
}
}Если файл уже есть, добавьте сервер внутрь ключа servers.
Ключи и настройки
OPENAPI_MCP_HEADERSсекрет, обязательная
Замените значения в угловых скобках своими. Ключи не попадают в ссылки установки и не хранятся у нас.
Выполните в терминале
codex mcp add anytype --env 'OPENAPI_MCP_HEADERS=<ваш OPENAPI_MCP_HEADERS>' -- npx -y @anyproto/anytype-mcpИли добавьте в файл ~/.codex/config.toml, для всех проектов
[mcp_servers.anytype]
command = "npx"
args = ["-y", "@anyproto/anytype-mcp"]
env = { OPENAPI_MCP_HEADERS = "<ваш OPENAPI_MCP_HEADERS>" }Если файл уже есть, допишите блок в конец.
Ключи и настройки
OPENAPI_MCP_HEADERSсекрет, обязательная
Замените значения в угловых скобках своими. Ключи не попадают в ссылки установки и не хранятся у нас.
Добавьте в файл ~/.gemini/settings.json, для всех проектов
{
"mcpServers": {
"anytype": {
"command": "npx",
"args": [
"-y",
"@anyproto/anytype-mcp"
],
"env": {
"OPENAPI_MCP_HEADERS": "<ваш OPENAPI_MCP_HEADERS>"
}
}
}
}Если файл уже есть, добавьте сервер внутрь ключа mcpServers.
Ключи и настройки
OPENAPI_MCP_HEADERSсекрет, обязательная
Замените значения в угловых скобках своими. Ключи не попадают в ссылки установки и не хранятся у нас.
Добавьте в файл ~/.config/devin/mcp_config.json, для всех проектов
{
"mcpServers": {
"anytype": {
"command": "npx",
"args": [
"-y",
"@anyproto/anytype-mcp"
],
"env": {
"OPENAPI_MCP_HEADERS": "<ваш OPENAPI_MCP_HEADERS>"
}
}
}
}Если файл уже есть, добавьте сервер внутрь ключа mcpServers. В легаси Cascade конфиг MCP лежит в ~/.codeium/windsurf/mcp_config.json.
Ключи и настройки
OPENAPI_MCP_HEADERSсекрет, обязательная
Замените значения в угловых скобках своими. Ключи не попадают в ссылки установки и не хранятся у нас.
Бывший Windsurf.
Добавьте в файл cline_mcp_settings.json, для всех проектов
{
"mcpServers": {
"anytype": {
"command": "npx",
"args": [
"-y",
"@anyproto/anytype-mcp"
],
"env": {
"OPENAPI_MCP_HEADERS": "<ваш OPENAPI_MCP_HEADERS>"
}
}
}
}Если файл уже есть, добавьте сервер внутрь ключа mcpServers. Файл настроек открывается в Cline: вкладка MCP Servers, кнопка Configure MCP Servers.
Ключи и настройки
OPENAPI_MCP_HEADERSсекрет, обязательная
Замените значения в угловых скобках своими. Ключи не попадают в ссылки установки и не хранятся у нас.
Добавьте в файл .roo/mcp.json, в проекте
{
"mcpServers": {
"anytype": {
"command": "npx",
"args": [
"-y",
"@anyproto/anytype-mcp"
],
"env": {
"OPENAPI_MCP_HEADERS": "<ваш OPENAPI_MCP_HEADERS>"
}
}
}
}Если файл уже есть, добавьте сервер внутрь ключа mcpServers.
Ключи и настройки
OPENAPI_MCP_HEADERSсекрет, обязательная
Замените значения в угловых скобках своими. Ключи не попадают в ссылки установки и не хранятся у нас.
Форк Roo Code, папки .roo те же.
Добавьте в файл opencode.json, в проекте
{
"mcp": {
"anytype": {
"type": "local",
"command": [
"npx",
"-y",
"@anyproto/anytype-mcp"
],
"environment": {
"OPENAPI_MCP_HEADERS": "<ваш OPENAPI_MCP_HEADERS>"
}
}
}
}Если файл уже есть, добавьте сервер внутрь ключа mcp.
Ключи и настройки
OPENAPI_MCP_HEADERSсекрет, обязательная
Замените значения в угловых скобках своими. Ключи не попадают в ссылки установки и не хранятся у нас.
Добавьте в файл ~/.config/zed/settings.json, для всех проектов
{
"context_servers": {
"anytype": {
"command": "npx",
"args": [
"-y",
"@anyproto/anytype-mcp"
],
"env": {
"OPENAPI_MCP_HEADERS": "<ваш OPENAPI_MCP_HEADERS>"
}
}
}
}Если файл уже есть, добавьте сервер внутрь ключа context_servers.
Ключи и настройки
OPENAPI_MCP_HEADERSсекрет, обязательная
Замените значения в угловых скобках своими. Ключи не попадают в ссылки установки и не хранятся у нас.
Добавьте в файл .codeassistant/mcp.json, в проекте
{
"mcpServers": {
"anytype": {
"command": "npx",
"args": [
"-y",
"@anyproto/anytype-mcp"
],
"env": {
"OPENAPI_MCP_HEADERS": "<ваш OPENAPI_MCP_HEADERS>"
}
}
}
}Если файл уже есть, добавьте сервер внутрь ключа mcpServers.
Ключи и настройки
OPENAPI_MCP_HEADERSсекрет, обязательная
Замените значения в угловых скобках своими. Ключи не попадают в ссылки установки и не хранятся у нас.
Создай ключ API в настройках приложения Anytype. Добавь в конфигурацию MCP-клиента сервер anytype: command npx, args -y @anyproto/anytype-mcp, в env задай OPENAPI_MCP_HEADERS со значением вида {"Authorization":"Bearer ключ", "Anytype-Version":"дата"}.
Другие способы из описания автора
{
"mcpServers": {
"anytype": {
"command": "npx",
"args": ["-y", "@anyproto/anytype-mcp"],
"env": {
"OPENAPI_MCP_HEADERS": "{\"Authorization\":\"Bearer <YOUR_API_KEY>\", \"Anytype-Version\":\"2025-11-08\"}"
}
}
}
}Сначала создайте ключ API в приложении Anytype и подставьте его в заголовок Authorization.
Это чужой код. Посмотрите файлы в репозитории перед установкой.
Что делает
Сервер подключает агента к API приложения Anytype и превращает его спецификацию OpenAPI в набор инструментов MCP. Через диалог агент ищет по всем пространствам и внутри одного, работает с пространствами и участниками, объектами и списками, свойствами, тегами, типами и шаблонами. Успешные создание, правка и удаление возвращают компактную квитанцию с id объекта, а для защиты от перезаписи поддерживаются условие по etag и ключ идемпотентности. Сервер выбирает версию API при запуске: сначала пробует v2, при отсутствии откатывается на v1.
Для кого. Для тех, кто ведет базу знаний или личную вики в Anytype и хочет управлять ей через агента.
Подходит, если
- Нужно искать и собирать объекты в базе знаний Anytype
- Нужно создавать задачи, заметки и списки естественным языком
- Нужно обновлять свойства, теги и типы объектов
Не подходит, если
- Не установлено приложение Anytype с включенным API
- Нельзя доверять клиенту изменение и удаление объектов базы
Пример запроса к агенту
Создай задачу изучить тренды AI со сроком через три дня и добавь ее в список задач на неделюОграничения
Нужны установленное приложение Anytype и ключ API, который создается в настройках приложения. Ключ передается через переменную OPENAPI_MCP_HEADERS в заголовке Authorization вместе с версией API. По умолчанию сервер обращается к локальному адресу приложения, для anytype-cli или другого адреса задается ANYTYPE_API_BASE_URL. Управление ключами и парой устройств, а также потоковые инструменты из набора исключены. Запуск через npx требует Node.js.
Как отключить. Удалите блок anytype из конфигурации MCP-клиента и перезапустите его, при желании отзовите ключ API в настройках приложения Anytype.
MCP
- Транспорт
- stdio
- Авторизация
- API-ключ
| Переменные окружения | |
|---|---|
| OPENAPI_MCP_HEADERS обязательная, секрет | JSON с заголовком Authorization и Bearer-ключом API и версией Anytype |
| ANYTYPE_API_BASE_URL | Базовый адрес API для anytype-cli или своего порта |
Проверка безопасности
- Создает, меняет и удаляет объекты в вашей базе знаний Anytype
- Работает с ключом API, который передается в заголовке Authorization
Коротко о README
README описывает получение ключа API в приложении Anytype и настройку клиентов Claude Desktop, Cursor, Windsurf и Claude Code через npx с переменной OPENAPI_MCP_HEADERS. Возможности охватывают поиск по пространствам, объекты и списки, свойства и теги, типы и шаблоны. Подробно разобрано поведение инструментов: выбор версии API v2 или v1, компактные квитанции при записи, условие по etag и ключ идемпотентности, исключение управления ключами и потоковых инструментов. Есть настройка своего базового адреса API и установка из исходников через Bun. Проект развивает Any, лицензия MIT.
Частые вопросы
Где взять ключ API?
В приложении Anytype в разделе настроек API Keys кнопкой создания нового ключа. Есть и вариант через командную строку с получением ключа.
Как выбирается версия API?
Сервер при запуске сначала пробует спецификацию v2, а при ее отсутствии откатывается на v1. Можно указать конкретную версию явным адресом спецификации.
Похожие
Самостоятельно размещаемая база знаний с блочными ссылками и встроенным MCP-сервером для подключения AI-агентов к заметкам
CLI для всех API Google Workspace с выводом в JSON и набором скиллов для агентов: Drive, Gmail, Calendar, Sheets и другие
Локальный поиск по заметкам, документации и расшифровкам встреч в Markdown: ключевые слова, смысловой поиск и ранжирование, есть MCP
Менеджер задач для AI-разработки: разбирает PRD на задачи с зависимостями и ведет агента по ним через MCP или CLI