---
title: 'MCP для AI-агентів'
description: 'Як підключити Claude, Codex, OpenCode, OpenClaw або Hermes до платформи через MCP.'
type: doc
locale: uk
canonical: 'https://yoseno.com/uk/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/uk/docs/integrations/api-tokens.md). MCP потрібен саме AI-агентам, яким важливі tools, resources, prompts, OAuth та окремі scopes.

## Пов’язані сторінки

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

## Читати далі

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