Підключити асистента
Ocost також є сервером Model Context Protocol (MCP). Підключіть Claude Desktop, Claude Code, Cursor чи іншого асистента, і він шукатиме ваші документи, читатиме їх, запитуватиме ваші показники та надсилатиме файли. claude.ai і ChatGPT підключаються через OAuth, а не за ключем.
Сервер
https://api.ocost.io/public/mcp
Authorization: Bearer ocost_sk_<id>_<secret>Сервер працює через Streamable HTTP і не зберігає сесій, тож кожен запит самостійний. https://app.ocost.io/public/mcp — той самий сервер. Дайте кожному асистенту власний ключ лише з потрібними йому дозволами. Тоді ви бачите його останнє використання в Налаштуваннях › Розробникам і можете відкликати лише його. Інструменти MCP перелічує кожен інструмент із його дозволом та аргументами.
Claude Code
Додайте сервер із ключем зі змінної середовища:
claude mcp add --transport http ocost https://api.ocost.io/public/mcp \
--header "Authorization: Bearer $OCOST_KEY"Після цього claude mcp list показує ocost як підключений. Щоб поділитися сервером у репозиторії, додайте його в .mcp.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.
{
"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 проєкту:
{
"mcpServers": {
"ocost": {
"url": "https://api.ocost.io/public/mcp",
"headers": { "Authorization": "Bearer ${env:OCOST_KEY}" }
}
}
}claude.ai і ChatGPT
Ці застосунки додають сервери лише через OAuth. Ключ вам не потрібен: ви входите в Ocost і дозволяєте доступ.
- Додайте власний конектор. У claude.ai відкрийте Settings › Connectors › Add custom connector. У ChatGPT додайте власний конектор у режимі розробника.
- Введіть лише URL
https://api.ocost.io/public/mcp. Залиште client ID і secret порожніми. - Увійдіть в Ocost, коли застосунок його відкриє. Якщо ви належите до кількох компаній, виберіть одну в Інша компанія.
- Позначте дозволи, які надаєте, і підтвердьте. Дозволити доступ можуть лише власник і бухгалтер.
Після цього застосунок діє від вашого імені, з вашими правами. Він отримує власний ключ, указаний як "<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 та ідентифікатора сесії. Отримайте список інструментів, щоб перевірити з’єднання:
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 списки й показники також приходять як інтерактивна таблиця чи діаграма.
Кожен виклик записується, без слів документа. Власник і бухгалтер бачать останні виклики ключа в Налаштуваннях › Розробникам.