---
title: 'MCP для AI-агентов'
description: 'Как подключить Claude, Codex, OpenCode, OpenClaw или Hermes к платформе через MCP.'
type: doc
locale: ru
canonical: 'https://yoseno.com/ru/docs/integrations/mcp-agent'
updated: '2026-07-30'
---

# MCP для AI-агентов

Как подключить Claude, Codex, OpenCode, OpenClaw или Hermes к платформе через MCP.

MCP даёт внешнему AI-агенту рабочий доступ к платформе: читать аналитику, помогать с
опросами и выполнять действия от имени пользователя. Подключение идёт через Streamable HTTP
endpoint:

```txt
https://<домен-платформы>/mcp
```

При первом обращении агент открывает OAuth-вход в браузере. Вы видите, какой клиент просит
доступ и какие scopes он запрашивает. После подтверждения токен хранит сам MCP-клиент;
вручную копировать секрет не нужно.

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

## Claude

Для Claude Code добавьте HTTP MCP-сервер:

```bash
claude mcp add --transport http platform https://<домен-платформы>/mcp
```

Откройте Claude Code и выполните `/mcp`, затем пройдите OAuth в браузере. Если нужно
запустить вход из терминала, используйте:

```bash
claude mcp login platform
```

## Codex

Добавьте Streamable HTTP сервер:

```bash
codex mcp add platform --url https://<домен-платформы>/mcp
```

Затем выполните OAuth-вход:

```bash
codex mcp login platform
```

В Codex CLI состояние подключения видно через `/mcp`.

## OpenCode

Добавьте сервер в `opencode.json`:

```json
{
  "$schema": "https://opencode.ai/config.json",
  "mcp": {
    "platform": {
      "type": "remote",
      "url": "https://<домен-платформы>/mcp",
      "enabled": true
    }
  }
}
```

При первом использовании OpenCode предложит авторизоваться. Вручную запустить OAuth можно
так:

```bash
opencode mcp auth platform
```

## OpenClaw

Сохраните MCP-сервер как Streamable HTTP и включите OAuth:

```bash
openclaw mcp add platform \
  --url https://<домен-платформы>/mcp \
  --transport streamable-http \
  --auth oauth
```

Запустите вход и проверьте подключение:

```bash
openclaw mcp login platform
openclaw mcp doctor platform --probe
```

Если `login` вернул код подтверждения, завершите вход командой:

```bash
openclaw mcp login platform --code <code>
```

Если редактируете конфиг вручную, форма такая:

```json
{
  "mcp": {
    "servers": {
      "platform": {
        "url": "https://<домен-платформы>/mcp",
        "transport": "streamable-http",
        "auth": "oauth"
      }
    }
  }
}
```

## Hermes

Добавьте сервер в `~/.hermes/config.yaml`:

```yaml
mcp_servers:
  platform:
    url: "https://<домен-платформы>/mcp"
    auth: oauth
```

Запустите Hermes. При первом подключении он откроет OAuth в браузере и сохранит токены для
следующих сессий. После изменения конфига в уже открытой сессии выполните:

```txt
/reload-mcp
```

## Доступ

Агент получает только подтверждённые scopes:

- `analytics:read` — читать опросы, результаты, аналитику и точки роста;
- `surveys:write` — создавать, редактировать и публиковать опросы;
- `org:manage` — управлять организациями, настройками и участниками.

Scopes не заменяют роль пользователя. Если ваша роль не позволяет выполнить действие в
организации, агент тоже не сможет его выполнить.

## Лимиты запросов

Обращения к MCP защищены лимитами частоты:
- Рабочий endpoint `/mcp`: 300 запросов в минуту на токен или IP.
- OAuth-авторизация: 20 запросов на пару IP + client_id за 5 минут (120 запросов на IP).

При превышении сервер возвращает ошибку `rate_limited` с указанием времени паузы (`retryAfter`).

## Приватность

MCP не открывает ответы участников в обход правил платформы. Ответы в чистом виде не видит
никто; наружу выходят только обезличенные данные и агрегаты при достаточном числе ответов
(не меньше 5). Если данных мало, агент получит ограниченный результат.

Для обычных скриптов и серверных интеграций используйте [API-токены](https://yoseno.com/ru/docs/integrations/api-tokens.md).
MCP нужен именно AI-агентам, которым важны tools, resources, prompts, OAuth и отдельные scopes.

## Связанные страницы

- [API-токены](https://yoseno.com/ru/docs/integrations/api-tokens.md) — Персональные токены и bearer-доступ к \`/api/v1\`.
- [Кредиты и лимиты](https://yoseno.com/ru/docs/account/billing-plans.md) — Кредиты, покупки, подписка и поведение AI-функций при нехватке.
- [REST API](https://yoseno.com/ru/docs/integrations/rest-api.md) — Токены, Bearer-доступ, пример запроса и ссылки на OpenAPI-референс.

## Читать дальше

- [REST API](https://yoseno.com/ru/docs/integrations/rest-api.md) — Токены, Bearer-доступ, пример запроса и ссылки на OpenAPI-референс.