MCP-сервер Nodary

У Nodary есть удалённый MCP-сервер, поэтому ИИ-агент читает и изменяет ваше рабочее пространство так же, как коллега по команде: те же документы, те же права, вход от вашего имени.

Коротко

Адрес: https://nodary.ai/api/mcp
Транспорт: Streamable HTTP (JSON-RPC через POST)
Вход: OAuth 2.1 с динамической регистрацией клиента и PKCE или ключ API
Доступ: Входит во все тарифы; на Free в пределах лимитов тарифа
Обнаружение: https://nodary.ai/.well-known/oauth-protected-resource/api/mcp · https://nodary.ai/.well-known/mcp.json

Claude Code: Выполните эту команду в терминале (добавьте --scope user, чтобы использовать Nodary во всех проектах):

claude mcp add --transport http nodary https://nodary.ai/api/mcp

Что это такое

Model Context Protocol (MCP) это открытый стандарт, по которому ИИ-клиенты работают с внешними инструментами. Сервер Nodary открывает агенту то же рабочее пространство, что и вашей команде: проекты, документы и связи между ними, электронные таблицы, изображения, таблицы перевода, диалоги и доски.

Агент не получает копию. Он читает то, что есть сейчас, пишет туда, куда вы попросите, и каждый результат содержит ссылку, по которой человек может открыть и проверить его работу.

Вход

Большинство клиентов входят через OAuth: укажите адрес сервера, и клиент откроет в браузере страницу входа и согласия Nodary. Nodary поддерживает OAuth 2.1 с динамической регистрацией клиента и PKCE, поэтому не нужно создавать идентификатор клиента и ничего не нужно копировать. Токены доступа действуют час, и клиент сам их обновляет.

Одно подключение может охватывать несколько пространств. Если вы состоите в нескольких, страница согласия показывает их все с отметками: приложение получает доступ к пространствам, которые остались отмеченными, и только к ним. «А также пространства, в которые я вступлю позже» остаётся выключенным, пока вы его не отметите. В таком подключении каждый инструмент принимает workspace (идентификатор, slug или название): вызов, который что-то меняет, обязан его указать, чтение без него выполняется только там, где находятся его идентификаторы, а каждый результат начинается с пространства, в котором он выполнен. API-ключ остаётся привязан к одному пространству.

Клиент, который не умеет выполнять вход, может использовать ключ API: создайте его в профиле, в разделе API keys & MCP (он начинается с gdc_), и передавайте в заголовке Authorization: Bearer gdc_… Ключ можно ограничить одним проектом.

Кто может им пользоваться

MCP-сервер входит во все тарифы, Free, Pro, Studio и Enterprise, для каждого участника и без доплаты.

На Free агент читает и пишет так же, как на платном тарифе, пока рабочее пространство укладывается в тариф: проекты (1), документы и папки (10), участники (2). Запись, которая превысила бы лимит, отклоняется с указанием этого лимита и способа его снять: пока пространство ещё может получить пробный период, со ссылкой на панель управления, где владелец или администратор начинает пробный период Studio (14 дн.) с MCP и без карты; иначе со ссылкой на страницу цен.

Пространство, превышающее тариф Free после пробного периода и без подписки, заблокировано до оформления подписки: агенты там отключены, в том числе для чтения. Подключение только к этому пространству получает quota_locked на каждый запрос с тем, что превышено, и с адресом, где владелец оформляет подписку; подключение к нескольким пространствам получает quota_locked (или billing_locked после неудачного платежа) только на вызовы в заблокированное пространство, как ошибку инструмента, и продолжает работать в остальных.

Цены

Что умеет агент

Всего инструментов: 92, здесь они сгруппированы по задачам. Каждый сообщает клиенту, только ли он читает и может ли его запись что-то перезаписать, чтобы клиент мог спросить вас, прежде чем действовать.

Поиск и чтение

Проекты, документы с их связями и историей, комментарии, заметки базы знаний, сохранённые виды и брифы контекста. В результатах есть ссылки, которые люди могут открыть.

list_games
list_stars
search_documents
get_document
get_star
get_tree
list_templates
list_members
list_project_knowledge
get_project_knowledge
list_comments
get_canon
list_versions
get_version
diff_versions
list_deleted_stars
list_context_briefs
get_context_brief
list_saved_views
get_saved_view
list_favorites
get_workspace_usage
list_properties
get_file_url
describe_blocks
run_view
list_workspaces

Запись и организация

Создание и правка документов блок за блоком, раскладывание по папкам, связи, теги, комментарии, свойства и разрешение противоречий. Удалённый документ можно восстановить.

create_game
update_game
rename_workspace
create_starter_constellation
create_from_template
create_star
create_stars
write_document
append_document
edit_document
update_star
update_stars
delete_star
restore_star
create_cluster
move_to_cluster
link_stars
unlink_stars
set_tags
save_project_knowledge
add_comment
add_comments
resolve_comment
list_contradictions
report_contradiction
resolve_contradiction
save_context_brief
save_saved_view
set_favorite
define_properties
set_properties
restore_version
edit_comment
delete_comment
delete_project_knowledge
remove_context_brief
remove_saved_view
open_daily_note

Арт-ревью и изображения

Загрузка изображений и их просмотр вместе с заметками, которые на них нарисовали люди; решения, заметки и теги для материалов на приёмку (каждое решение подписано: кто и когда); превращение мудборда в палитру и проверка изображения по ней; подготовка листа замечаний для аутсорсера.

add_image
start_upload
add_media
get_image
get_moodboard
render_board
edit_board
find_pictures
update_pictures
get_art_review
extract_palette
check_palette
feedback_sheet
restore_image_version
set_image_origin

Таблицы и баланс

Чтение листа в виде вычисленных значений с формулой за каждой ячейкой, запись ячеек по адресу или по строке и чтение таблицы лута с объяснением, что она значит для игроков.

get_sheet
set_cells
analyze_drops

Локализация и диалоги

Прогресс каждого языка в таблице перевода, запись переводов по ключу и проверка ветвящегося диалога, который экспортируется как скрипт Yarn Spinner.

get_localization
set_translations
check_dialogue

Продакшен

Назначение сроков, запрос и отправка рецензий, обзор недавних изменений и прогноз, уложится ли веха в срок.

get_progress
recent_changes
set_due_date
set_due_dates
request_review
submit_review

Промпты и ресурсы

Готовые запросы, которые клиент может предложить в виде команд:

weekly-summary: Что изменилось за неделю в рабочем пространстве или в одном проекте: что написано, решено и проверено, а что ещё открыто.
art-review: Где находится арт-ревью: изображения, ждущие решения, изображения, которые отходят от палитры, и что решать дальше.
playtest-to-tasks: Превращает заметки с плейтеста в задачи, каждая со ссылкой на дизайн-документ, которого она касается.
balance-review: Читает таблицу лута или кривую прогрессии и объясняет, что это значит для игроков и что выглядит не так.

Ресурсы, которые клиент может приложить без вызова инструмента:

nodary://star/{id}: документ в формате Markdown
nodary://project/{id}: структура проекта

Безопасность

Агент действует от имени того, кто его подключил: видит и меняет только то, что доступно этому человеку, а ключ, ограниченный проектом, не выходит за пределы этого проекта.
В подключении к нескольким пространствам ничего не разрешается между ними: идентификаторы и названия ищутся только в пространстве, указанном в вызове, идентификатор из другого пространства отклоняется до выполнения, а каждый результат называет своё пространство.
Документы хранят историю версий, а удалённый документ можно восстановить.
Инструменты записи принимают ключ идемпотентности: вызов, повторённый после обрыва соединения, возвращает первый результат и не записывает данные дважды.
Одно подключение делает не более 120 запросов в минуту; дневного лимита на запись нет.
Решения арт-ревью подписываются именем принявшего их человека и временем.
Nodary сообщает каждому агенту, что текст документов и комментариев является материалом для работы, а не инструкциями к исполнению. Как агент поступит с этим указанием, зависит от самого агента.

Подключите свой клиент

Используйте адрес https://nodary.ai/api/mcp. Каждый клиент ниже сверен с его собственной документацией 1 октября 2026 года.

Claude (claude.ai и Claude Desktop)

Откройте Customize, затем Connectors, и выберите Add custom connector.
Введите https://nodary.ai/api/mcp. Когда Claude спросит о способе регистрации, выберите Register automatically.
Подключитесь, войдите в Nodary и подтвердите доступ.

Пользовательские коннекторы доступны на тарифах Free, Pro, Max, Team и Enterprise; аккаунт Free может добавить один такой коннектор. На Team и Enterprise сначала владелец добавляет коннектор для организации.

ChatGPT

В Settings, в разделе Security and login, включите Developer mode.
Создайте приложение для удалённого MCP-сервера с адресом https://nodary.ai/api/mcp и входом через OAuth.
Войдите в Nodary и подтвердите доступ. После этого инструменты появятся в поле ввода в режиме Developer mode.

Developer mode доступен в веб-версии для аккаунтов Plus, Pro, Business, Enterprise и Education; на Business и Enterprise его, возможно, должен разрешить администратор. ChatGPT подключается только через OAuth, без ключа API.

Claude Code

Выполните эту команду в терминале (добавьте --scope user, чтобы использовать Nodary во всех проектах):
```
claude mcp add --transport http nodary https://nodary.ai/api/mcp
```
В Claude Code введите /mcp, выберите nodary и войдите через браузер.

Или с ключом API

claude mcp add --transport http nodary https://nodary.ai/api/mcp \
  --header "Authorization: Bearer gdc_..."

Cursor

Добавьте Nodary в ~/.cursor/mcp.json (для всех проектов) или в .cursor/mcp.json (для одного проекта):
```
{
  "mcpServers": {
    "nodary": {
      "url": "https://nodary.ai/api/mcp"
    }
  }
}
```
Cursor предложит войти, когда сервер впервые этого потребует.

Или с ключом API

{
  "mcpServers": {
    "nodary": {
      "url": "https://nodary.ai/api/mcp",
      "headers": {
        "Authorization": "Bearer ${env:NODARY_API_KEY}"
      }
    }
  }
}

VS Code (GitHub Copilot)

Добавьте Nodary в файл .vscode/mcp.json вашего рабочего пространства или выполните команду MCP: Add Server:
```
{
  "servers": {
    "nodary": {
      "type": "http",
      "url": "https://nodary.ai/api/mcp"
    }
  }
}
```
Запустите сервер; VS Code откроет страницу входа Nodary.

В Copilot Business и Enterprise администратор сначала должен разрешить MCP-серверы.

Или с ключом API

{
  "inputs": [
    {
      "type": "promptString",
      "id": "nodary-key",
      "description": "Nodary API key",
      "password": true
    }
  ],
  "servers": {
    "nodary": {
      "type": "http",
      "url": "https://nodary.ai/api/mcp",
      "headers": {
        "Authorization": "Bearer ${input:nodary-key}"
      }
    }
  }
}

Devin Desktop (ранее Windsurf)

Добавьте сервер и войдите из терминала:
```
devin mcp add -s user nodary https://nodary.ai/api/mcp
devin mcp login nodary
```
Или добавьте его в ~/.config/devin/mcp_config.json (в Windows: %APPDATA%\devin\mcp_config.json):
```
{
  "mcpServers": {
    "nodary": {
      "url": "https://nodary.ai/api/mcp",
      "transport": "http"
    }
  }
}
```

Если что-то не работает

Ответ 401 с адресом resource_metadata на первый запрос ожидаем: так сервер сообщает клиенту, где выполнить вход.
Если запрос отклонён с quota_locked, значит, после пробного периода пространство превышает тариф Free и заблокировано до оформления подписки: как только владелец оформит подписку, агент снова заработает. В подключении к нескольким пространствам отклоняются только вызовы в это пространство.
Вызов, отклонённый с workspace_required (или workspace_not_found), перечисляет пространства, доступные подключению: передайте одно из них в workspace. Чтобы получить доступ к пространству, которого нет в списке, подключите приложение заново и отметьте его.
Если клиент не может завершить вход, подключите его с ключом API.