# 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 во всех проектах):

```sh
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 после неудачного платежа) только на вызовы в заблокированное пространство, как ошибку инструмента, и продолжает работать в остальных.

- [Цены](https://nodary.ai/ru/pricing)

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

Всего инструментов: 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)

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

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

### ChatGPT

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

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

### Claude Code

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

   ```
   claude mcp add --transport http nodary https://nodary.ai/api/mcp
   ```
2. В Claude Code введите /mcp, выберите nodary и войдите через браузер.

Или с ключом API

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

### Cursor

1. Добавьте Nodary в ~/.cursor/mcp.json (для всех проектов) или в .cursor/mcp.json (для одного проекта):

   ```
   {
     "mcpServers": {
       "nodary": {
         "url": "https://nodary.ai/api/mcp"
       }
     }
   }
   ```
2. Cursor предложит войти, когда сервер впервые этого потребует.

Или с ключом API

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

### VS Code (GitHub Copilot)

1. Добавьте Nodary в файл .vscode/mcp.json вашего рабочего пространства или выполните команду MCP: Add Server:

   ```
   {
     "servers": {
       "nodary": {
         "type": "http",
         "url": "https://nodary.ai/api/mcp"
       }
     }
   }
   ```
2. Запустите сервер; VS Code откроет страницу входа Nodary.

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

Или с ключом API

```json
{
  "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)

1. Добавьте сервер и войдите из терминала:

   ```
   devin mcp add -s user nodary https://nodary.ai/api/mcp
   devin mcp login nodary
   ```
2. Или добавьте его в ~/.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.

https://nodary.ai/ru/docs/mcp