Підключити асистента

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 перелічує кожен інструмент із його дозволом та аргументами.

Claude Code

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

Shell
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 та ідентифікатора сесії. Отримайте список інструментів, щоб перевірити з’єднання:

Shell
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. Жоден ключ чи з’єднання ніколи не читає особисті папери людей, як-от розрахункові листи чи лікарняні.

Жоден інструмент нічого не видаляє, не затверджує і не замовляє. Ліміти API діють для кожного виклику інструмента.

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

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

Див. також