MCP-сервер Nodary

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

Коротко

Адрес: https://nodary.ai/api/mcp
Транспорт: Streamable HTTP (JSON-RPC через POST)
Вход: OAuth 2.1 с динамической регистрацией клиента и PKCE или ключ API
Доступ: Дополнение MCP на платном тарифе: 30 € за участника или 200 € за всё рабочее пространство, в месяц
Обнаружение: 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, поэтому не нужно создавать идентификатор клиента и ничего не нужно копировать. Токены доступа действуют час, и клиент сам их обновляет.

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

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

MCP-сервер это дополнение к платному тарифу (Pro, Studio или Enterprise): 30 € за участника в месяц или 200 € в месяц за всё рабочее пространство.

Владелец рабочего пространства включает его в разделе «Администрирование». Если у владельца ещё нет доступа, то при выдаче доступа участнику владелец тоже получает место. Участник без доступа может запросить его в своём профиле, и владелец получит уведомление.

Цены

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

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

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

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

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

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

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

create_game
update_game
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

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

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

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 на первый запрос ожидаем: так сервер сообщает клиенту, где выполнить вход.
Если вызов инструмента сообщает, что требуется дополнение MCP, значит, владелец ещё не включил его для вас.
Если клиент не может завершить вход, подключите его с ключом API.