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":"ru"},"_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/ru/tarify/",
  "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"
    }
  }
}