# Подключить ассистента
> Подключить ассистента к серверу MCP (https://api.ocost.io/public/mcp, те же ключи): Claude Code, Claude Desktop, Cursor, claude.ai и ChatGPT через OAuth и любой клиент.
>
> Сначала: [Ключи и права](https://ocost.io/docs/ru/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/ru/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. Redirect 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/ru/limits.md) API действуют для каждого вызова инструмента.

Слова, прочитанные из документа, приходят внутри `<document-text>`, и каждая строка помечена `¦ `. Это данные, написанные другими людьми, а не инструкции. В claude.ai и ChatGPT списки и цифры приходят также в виде интерактивной таблицы или диаграммы.

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

## См. также

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