# Підключити асистента
> Підключити асистента до сервера MCP (https://api.ocost.io/public/mcp, ті самі ключі): Claude Code, Claude Desktop, Cursor, claude.ai і ChatGPT через OAuth, а також будь-який клієнт.
>
> Спершу: [Ключі та дозволи](https://ocost.io/docs/uk/authentication.md)

Ocost також є сервером Model Context Protocol (MCP). Підключіть Claude Desktop, Claude Code, Cursor чи іншого асистента, і він шукатиме ваші документи, читатиме їх, запитуватиме ваші показники та надсилатиме файли. claude.ai і ChatGPT підключаються через OAuth, а не за ключем.

## Сервер

```text
https://api.ocost.io/public/mcp
Authorization: Bearer ocost_sk_<id>_<secret>
```

Сервер працює через Streamable HTTP і не зберігає сесій, тож кожен запит самостійний. `https://app.ocost.io/public/mcp` — той самий сервер. Дайте кожному асистенту власний ключ лише з потрібними йому дозволами. Тоді ви бачите його останнє використання в Налаштуваннях › Розробникам і можете відкликати лише його. [Інструменти MCP](https://ocost.io/docs/uk/tools.md) перелічує кожен інструмент із його дозволом та аргументами.

## Claude Code

Додайте сервер із ключем зі змінної середовища:

```bash
claude mcp add --transport http ocost https://api.ocost.io/public/mcp \
  --header "Authorization: Bearer $OCOST_KEY"
```

Після цього `claude mcp list` показує `ocost` як підключений. Щоб поділитися сервером у репозиторії, додайте його в `.mcp.json`. Тримайте ключ у середовищі кожного розробника, ніколи у файлі:

```json
{
  "mcpServers": {
    "ocost": {
      "type": "http",
      "url": "https://api.ocost.io/public/mcp",
      "headers": { "Authorization": "Bearer ${OCOST_KEY}" }
    }
  }
}
```

## Claude Desktop

Відкрийте Settings › Developer › Edit Config і додайте Ocost у `claude_desktop_config.json`. `mcp-remote` пересилає запити з вашим заголовком, і йому потрібен Node.js.

```json
{
  "mcpServers": {
    "ocost": {
      "command": "npx",
      "args": [
        "-y",
        "mcp-remote@0.15.2",
        "https://api.ocost.io/public/mcp",
        "--header",
        "Authorization:${OCOST_AUTH}"
      ],
      "env": { "OCOST_AUTH": "Bearer ocost_sk_…" }
    }
  }
}
```

Перезапустіть Claude Desktop, і інструменти з’являться під кнопкою інструментів. Пишіть `Authorization:${OCOST_AUTH}` без пробілів, бо деякі клієнти розділяють аргументи саме там.

## Cursor

Додайте Ocost у `~/.cursor/mcp.json` або в `.cursor/mcp.json` проєкту:

```json
{
  "mcpServers": {
    "ocost": {
      "url": "https://api.ocost.io/public/mcp",
      "headers": { "Authorization": "Bearer ${env:OCOST_KEY}" }
    }
  }
}
```

## claude.ai і ChatGPT

Ці застосунки додають сервери лише через OAuth. Ключ вам не потрібен: ви входите в Ocost і дозволяєте доступ.

1. Додайте власний конектор. У claude.ai відкрийте Settings › Connectors › Add custom connector. У ChatGPT додайте власний конектор у режимі розробника.
2. Введіть лише URL `https://api.ocost.io/public/mcp`. Залиште client ID і secret порожніми.
3. Увійдіть в Ocost, коли застосунок його відкриє. Якщо ви належите до кількох компаній, виберіть одну в **Інша компанія**.
4. Позначте дозволи, які надаєте, і підтвердьте. Дозволити доступ можуть лише власник і бухгалтер.

Після цього застосунок діє від вашого імені, з вашими правами. Він отримує власний ключ, указаний як "<App> (Connector)" в Налаштуваннях › Розробникам. Відкличте цей ключ, щоб одразу від’єднати застосунок. Застосунок сам оновлює свій токен доступу щогодини. Після 30 днів без використання з’єднання завершується, і ви підключаєте застосунок знову.

Створюєте власний клієнт OAuth? Ocost використовує OAuth 2.1 з PKCE (S256). Метадані розміщено за адресами `https://api.ocost.io/.well-known/oauth-protected-resource/public/mcp` (RFC 9728) і `https://app.ocost.io/.well-known/oauth-authorization-server` (RFC 8414). Ocost приймає Client ID Metadata Documents і Dynamic Client Registration. URI перенаправлення мають використовувати https і точно збігатися.

## Будь-який інший клієнт

Вкажіть клієнту URL із заголовком `Authorization`. Сервер відповідає на запити `POST` у форматі JSON, без потоку SSE та ідентифікатора сесії. Отримайте список інструментів, щоб перевірити з’єднання:

```bash
curl -sS https://api.ocost.io/public/mcp \
  -H "Authorization: Bearer $OCOST_KEY" \
  -H "Content-Type: application/json" \
  -H "Accept: application/json, text/event-stream" \
  -H "MCP-Protocol-Version: 2025-11-25" \
  -d '{"jsonrpc":"2.0","id":1,"method":"tools/list"}'
```

Без дійсного ключа сервер відповідає `401` з `WWW-Authenticate: Bearer`. Ваш вхід в Ocost — це не ключ.

## Що можуть інструменти

Ключ, створений у Налаштуваннях, діє від імені компанії. Він читає кожен документ поза Кошиком, але не особисті рішення людей. Ключ із `figures:read` створює лише власник. З’єднання OAuth діє від імені людини, яка його дозволила, і бачить те, що вона бачить у чаті Ocost. Жоден ключ чи з’єднання ніколи не читає особисті папери людей, як-от розрахункові листи чи лікарняні.

Жоден інструмент нічого не видаляє, не затверджує і не замовляє. [Ліміти](https://ocost.io/docs/uk/limits.md) API діють для кожного виклику інструмента.

Слова, прочитані з документа, надходять усередині `<document-text>`, і кожен рядок позначено `¦ `. Це дані, написані іншими, а не інструкції. У claude.ai і ChatGPT списки й показники також приходять як інтерактивна таблиця чи діаграма.

Кожен виклик записується, без слів документа. Власник і бухгалтер бачать останні виклики ключа в Налаштуваннях › Розробникам.

## Див. також

- [Інструменти MCP](https://ocost.io/docs/uk/tools.md): Кожен інструмент сервера MCP за дозволом: що він робить, його аргументи і приклад виклику.
- [Ключі та дозволи](https://ocost.io/docs/uk/authentication.md): Ключі API: як запит їх передає, заміна ключів, їхні дозволи і відмови.
- [Групи компаній](https://ocost.io/docs/uk/groups.md): Групи компаній: яких компаній сягає ключ, заголовок Ocost-Business, перенаправлення за кодами документа, needs_company і файли в групі.
- На ocost.io: [API and MCP](https://ocost.io/en/product/api-and-mcp)
