Підключіть Blogent до AI-асистентів через MCP

Контракт підключення

MCP endpoint

https://blogent.tools/mcp

Транспорт

Streamable HTTP через HTTPS. Кожне JSON-RPC повідомлення надсилайте окремим POST. GET повертає 405; SSE listener відсутній.

Версії протоколу

2025-06-18, 2025-11-25 і 2026-07-28. Якщо заголовок MCP-Protocol-Version передано, значення має бути одним із цих.

Авторизація

Authorization: Bearer <access_token>. Відсутній або прострочений токен повертає 401 із посиланням на metadata захищеного ресурсу.

Формат

UTF-8 JSON-RPC 2.0. Надсилайте Content-Type: application/json і Accept: application/json, text/event-stream; Blogent відповідає JSON.

Можливості

Лише tools. Немає resources, prompts, sampling або серверних notifications.

OAuth Authorization Code flow

Використовуйте публічний OAuth-клієнт із PKCE S256. Зберігайте й перевіряйте state, а точний канонічний MCP URL передавайте як resource і в authorization, і в token request.

1. Отримайте metadata захищеного ресурсу й authorization server з двох well-known URL.
2. Зареєструйте клієнт через POST /oauth/register. Redirect URI має використовувати HTTPS; HTTP дозволено лише для localhost loopback адрес.
3. Створіть PKCE verifier довжиною 43–128 символів, обчисліть SHA-256 base64url challenge і відкрийте GET /oauth/authorize у браузері користувача.
4. Після підтвердження перевірте state і обміняйте одноразовий code через POST /oauth/token. Код діє 10 хвилин.
5. Зберігайте токени безпечно. Access token діє 3600 секунд. Оновлюйте через grant_type=refresh_token; кожне оновлення інвалідовує попередній refresh token.
6. Під час відключення відкличте access або refresh token через POST /oauth/revoke.

Довідник OAuth endpoints

Готові приклади протоколу

Замініть плейсхолдери у верхньому регістрі. OAuth endpoints приймають стандартні form fields, MCP calls — JSON.

curl -X POST "https://blogent.tools/oauth/register" \
  -H "Content-Type: application/json" \
  --data '{
    "client_name": "Acme MCP Client",
    "redirect_uris": ["https://client.example.com/oauth/callback"],
    "grant_types": ["authorization_code", "refresh_token"],
    "response_types": ["code"],
    "token_endpoint_auth_method": "none"
  }'

GET https://blogent.tools/oauth/authorize
  ?response_type=code
  &client_id=CLIENT_ID
  &redirect_uri=https%3A%2F%2Fclient.example.com%2Foauth%2Fcallback
  &scope=projects%3Aread%20projects%3Awrite%20billing%3Aread%20billing%3Awrite
  &state=RANDOM_OPAQUE_STATE
  &code_challenge=BASE64URL_SHA256_OF_VERIFIER
  &code_challenge_method=S256
  &resource=https%3A%2F%2Fblogent.tools%2Fmcp

curl -X POST "https://blogent.tools/oauth/token" \
  -H "Content-Type: application/x-www-form-urlencoded" \
  --data-urlencode "grant_type=authorization_code" \
  --data-urlencode "client_id=CLIENT_ID" \
  --data-urlencode "code=AUTHORIZATION_CODE" \
  --data-urlencode "redirect_uri=https://client.example.com/oauth/callback" \
  --data-urlencode "code_verifier=PKCE_VERIFIER" \
  --data-urlencode "resource=https://blogent.tools/mcp"

curl -X POST "https://blogent.tools/mcp" \
  -H "Authorization: Bearer ACCESS_TOKEN" \
  -H "Content-Type: application/json" \
  -H "Accept: application/json, text/event-stream" \
  -H "MCP-Protocol-Version: 2025-11-25" \
  --data '{"jsonrpc":"2.0","id":1,"method":"initialize","params":{"protocolVersion":"2025-11-25","capabilities":{},"clientInfo":{"name":"acme-client","version":"1.0.0"}}}'

curl -X POST "https://blogent.tools/mcp" \
  -H "Authorization: Bearer ACCESS_TOKEN" \
  -H "Content-Type: application/json" \
  -H "Accept: application/json, text/event-stream" \
  -H "MCP-Protocol-Version: 2025-11-25" \
  --data '{"jsonrpc":"2.0","method":"notifications/initialized"}'

curl -X POST "https://blogent.tools/mcp" \
  -H "Authorization: Bearer ACCESS_TOKEN" \
  -H "Content-Type: application/json" \
  -H "Accept: application/json, text/event-stream" \
  -H "MCP-Protocol-Version: 2025-11-25" \
  --data '{"jsonrpc":"2.0","id":2,"method":"tools/list","params":{}}'

curl -X POST "https://blogent.tools/mcp" \
  -H "Authorization: Bearer ACCESS_TOKEN" \
  -H "Content-Type: application/json" \
  -H "Accept: application/json, text/event-stream" \
  -H "MCP-Protocol-Version: 2025-11-25" \
  --data '{
    "jsonrpc": "2.0",
    "id": 3,
    "method": "tools/call",
    "params": {
      "name": "create_project",
      "arguments": {
        "domain": "example.com",
        "company": "Example",
        "languages": ["en"],
        "company_description": "Factual context approved by the customer."
      }
    }
  }'

Довідник аргументів tools

Машиночитним джерелом правди завжди є актуальна відповідь tools/list: вона містить inputSchema, outputSchema та annotations кожного tool.

Довідник полів проєкту

Невідомі поля відхиляються. create_project вимагає перші чотири поля; update_project.changes приймає будь-яку непорожню підмножину без domain.

Формат відповіді

Успішний tool повертає читабельний content і машиночитний structuredContent. Бізнес- та validation-помилки повертаються з HTTP 200 і result.isError=true. Помилки протоколу використовують JSON-RPC об’єкт error.

{
  "jsonrpc": "2.0",
  "id": 3,
  "result": {
    "content": [{"type": "text", "text": "Project created without charging the user. Present billing plans next."}],
    "structuredContent": {"project": {}, "next_actions": []},
    "isError": false
  }
}

{
  "jsonrpc": "2.0",
  "id": 4,
  "result": {
    "content": [{"type": "text", "text": "The connected account did not grant the projects:write scope."}],
    "isError": true
  }
}

Помилки, повторні запити та ідемпотентність

End-to-end checklist приймання

1. Discovery повертає production HTTPS issuer, MCP resource, endpoints і підтримувані scopes.
2. Dynamic registration успішна; клієнт перевіряє OAuth state і PKCE verifier.
3. Перевірено token exchange, одну refresh rotation і revocation без логування сирих tokens.
4. initialize (для версій 2025) і tools/list працюють із bearer token; кожен tool має input та output schema.
5. Read-only call працює, а відсутній scope повертає result.isError=true.
6. Test project створюється лише після confirmation, потім читається й оновлюється за normalized domain.
7. Custom topics додаються без видалення наявних; дублікати ігноруються.
8. Усі billing plans показано до явного вибору period користувачем.
9. Створено Stripe test checkout, повтор із тим самим period перевикористано, payment показано лише після webhook confirmation.
10. Disconnect відкликає token; наступний MCP access повертає 401.

Довідка про протокол: Streamable HTTP, MCP authorization і MCP schema. Для цього endpoint поведінка Blogent, описана на цій сторінці, має пріоритет.