MCP-сервер Satelit

Адреса й протокол

Один endpoint для обох епох протоколу. Без потоку SSE і без Mcp-Session-Id: кожен запит повний сам по собі.

2026-07-28, без стану

• Запит із _meta["io.modelcontextprotocol/protocolVersion"] належить до нової епохи.
• Заголовки MCP-Protocol-Version і Mcp-Method мають збігатися з тілом, а Mcp-Name з інструментом у tools/call (=?base64?…?= декодується). Інакше 400 -32020.
• Інша версія: 400 -32022 із supported.
• Результати містять resultType: "complete" і _meta["io.modelcontextprotocol/serverInfo"]. server/discover і tools/list містять ttlMs і cacheScope: public.

2025-11-25, 2025-06-18, 2025-03-26

• initialize відповідає запитаною версією, якщо знає її, інакше 2025-11-25.
• notifications/* отримують 202, ping отримує {}.
• Заголовок MCP-Protocol-Version, якщо він є, має бути однією з цих версій.

Решта

• Невідомий метод: -32601 (404 у новій епосі). Невідомий інструмент: -32602. Пакет запитів: 400.
• GET і DELETE: 405 з Allow. Origin, який не https і не ця машина: 403.
• resources/list і prompts/list відповідають порожніми списками.

curl https://api.satelit.md/mcp \
  -H "Authorization: Bearer $TOKEN" \
  -H "Content-Type: application/json" \
  -H "MCP-Protocol-Version: 2026-07-28" \
  -H "Mcp-Method: tools/call" \
  -H "Mcp-Name: search_prices" \
  -d '{"jsonrpc":"2.0","id":1,"method":"tools/call","params":{"name":"search_prices","arguments":{"query":"lapte 2.5%","lang":"uk"},"_meta":{"io.modelcontextprotocol/protocolVersion":"2026-07-28"}}}'

curl https://api.satelit.md/mcp \
  -H "Authorization: Bearer $TOKEN" \
  -H "Content-Type: application/json" \
  -d '{"jsonrpc":"2.0","id":1,"method":"initialize","params":{"protocolVersion":"2025-11-25","capabilities":{},"clientInfo":{"name":"my-app","version":"1.0"}}}'

Вхід: OAuth 2.1

Без токена відповідають рукостискання, ping і tools/list, і працюють кілька пошуків цін на день (у розділі про плани). Будь-який інший виклик або вичерпана спроба отримує 401 з WWW-Authenticate і адресою метаданих ресурсу: звідси клієнт починає вхід (вхід за потреби). З токеном: Authorization: Bearer, виданий для цього сервера й перевірений при кожному запиті; токен для іншого отримує 401, токен без скоупу mcp 403 insufficient_scope. tools/list позначає securitySchemes у кожного інструмента.

Метадані

• Захищений ресурс (RFC 9728): https://api.satelit.md/.well-known/oauth-protected-resource/mcp, і без /mcp.
• Сервер авторизації: https://app.satelit.md, з /.well-known/oauth-authorization-server і /.well-known/openid-configuration.
• Лише потік із кодом і PKCE S256. Скоупи: mcp offline_access; openid необовʼязковий.

Як застосунок реєструється

• Client ID Metadata Documents: client_id це https-адреса зі шляхом. Ми читаємо її (публічні адреси, порт 443, 5 с, 32 КБ, без редиректу); вона має називати саму себе й не носити імʼя Satelit. token_endpoint_auth_method: none або private_key_jwt з jwks_uri на тому самому хості. Перечитується через 24 години.
• Динамічна реєстрація (RFC 7591): POST https://app.satelit.md/api/oauth/register з redirect_uris. Адреси https або http на localhost, ніколи хост Satelit. 10 на годину з однієї адреси. Застосунок, який ніхто не схвалив за 7 днів, видаляється.
• Застосунок на компʼютері може використовувати будь-який порт своєї зареєстрованої loopback-адреси (RFC 8252 7.3).

Токени привʼязані до сервера

• resource (RFC 8707) в authorize і token: лише https://api.satelit.md/mcp, інакше invalid_target. Скоуп mcp без resource означає той самий ресурс.
• aud токена доступу це адреса сервера: він не відкриває нічого іншого, зокрема userinfo.
• Доступ живе довше за сесію в браузері: вихід із сайту не відключає застосунок. Він закінчується, коли людина відключає його в Налаштуваннях, у розділі Підключені застосунки, коли обліковий запис вимкнено чи видалено, або через 60 днів без використання.

Екран згоди називає хост, куди йде код (chatgpt.com, claude.ai, 127.0.0.1), що застосунок може робити і що ніколи не проходить.

HTTP/1.1 401 Unauthorized
WWW-Authenticate: Bearer
  resource_metadata="https://api.satelit.md/.well-known/oauth-protected-resource/mcp",
  scope="mcp offline_access"

{
  "resource": "https://api.satelit.md/mcp",
  "authorization_servers": [
    "https://app.satelit.md"
  ],
  "scopes_supported": [
    "mcp",
    "offline_access"
  ],
  "bearer_methods_supported": [
    "header"
  ],
  "resource_name": "Satelit",
  "resource_documentation": "https://developer.satelit.md/en/mcp/",
  "resource_policy_uri": "https://satelit.md/en/privacy/",
  "resource_tos_uri": "https://satelit.md/en/terms/"
}

Структуровані відповіді

Відмова це результат з isError: true і тілом, яке ШІ-застосунок може передати людині. Розмова триває. У відповідях немає цін і реклами.

• plan_requiredінструменту потрібен вищий план: needed_plan, your_plan, adds, plans_page, message.
• limit_reachedліміт: limit (minute, day, writes, distinct, pool, pages, watches), retry_after_s, далі next_plan, adds, plans_page або bulk (API) вище за останній план.
• moreплан обрізав список: shown, found, next_plan, plans_page. Немає, якщо нічого не обрізано.
• search_firstid, який не прийшов із сьогоднішнього пошуку людини.
• confirm_emaile-mail облікового запису не підтверджено.

{
  "status": "plan_required",
  "needed_plan": "Satelit Родина",
  "your_plan": "Satelit Безкоштовний",
  "adds": [
    "…"
  ],
  "plans_page": "https://satelit.md/uk/taryfy/",
  "message": "…"
}

{
  "query": "lapte 2.5%",
  "currency": "MDL",
  "page": 1,
  "pages": 1,
  "products": [
    "…"
  ],
  "found": 48,
  "more": {
    "shown": 5,
    "found": 48,
    "message": "…",
    "next_plan": "Satelit Родина",
    "plans_page": "…"
  }
}

Налаштування клієнтів

ChatGPT, Claude, Perplexity і Gemini приймають адресу у своїх налаштуваннях, далі відкривають вхід у Satelit. Редактори й командний рядок:

Встановити в Cursor Встановити у VS Code

Спробувати

Виклик, якому потрібен обліковий запис, отримує 401 з адресою метаданих: звідси будь-який клієнт входить. MCP Inspector і claude mcp add проходять увесь шлях.

claude mcp add --transport http satelit https://api.satelit.md/mcp

gemini mcp add --transport http satelit https://api.satelit.md/mcp

{
  "mcpServers": {
    "satelit": {
      "url": "https://api.satelit.md/mcp"
    }
  }
}

{
  "servers": {
    "satelit": {
      "type": "http",
      "url": "https://api.satelit.md/mcp"
    }
  }
}