MCP для SEOParse

Що таке MCP

MCP — відкритий протокол, який дозволяє AI-клієнту (наприклад, Claude Code чи іншому асистенту) підключатися до зовнішнього сервісу як до набору «тулів» (дій) і «ресурсів» (даних для читання), без окремого UI. SEOParse піднімає власний MCP-сервер поруч з основним застосунком: кожен тул MCP відповідає рівно одному ендпоінту публічного REST API /api/v1, і обидва беруть схеми даних з одного джерела правди — реєстру тулів нижче.

Що це дає

• AI-провайдер може читати URL, абзаци, речення, SERP-результати та конкурентів вашого сайту напряму.
• Довгі операції (парсинг, SERP-аналіз, перезапис сторінки) запускаються й відстежуються через задачі (job_id) — без очікування у відкритому запиті.
• Доступ обмежується персональним токеном зі scope'ами — AI бачить і може лише те, що дозволено і вашому обліковому запису, і самому токену.
• Кожен виклик логується окремо від інтерфейсу, з наскрізним ідентифікатором запиту, — завжди можна простежити, що саме зробив AI-клієнт.

Як підключити

1. Створіть персональний API-токен: Профіль → API Tokens. Оберіть потрібні scope'и (read/write/analyze/delete) — сирий секрет токена показується рівно один раз, збережіть його одразу. Видача токена (create_token) доступна лише через цю сторінку і REST напряму — це навмисно не тул MCP.
2. Підключіть одного з клієнтів нижче до адреси MCP-сервера: https://seoparse.site/mcp.

Claude Code

claude mcp add --transport http seoparse https://seoparse.site/mcp --header "Authorization: Bearer <ВАШ_ТОКЕН>"

або файл .mcp.json:

{
  "mcpServers": {
    "seoparse": {
      "type": "http",
      "url": "https://seoparse.site/mcp",
      "headers": { "Authorization": "Bearer <ВАШ_ТОКЕН>" }
    }
  }
}

Anthropic Messages API (MCP connector)

{
  "mcp_servers": [
    { "type": "url", "url": "https://seoparse.site/mcp", "name": "seoparse", "authorization_token": "<ВАШ_ТОКЕН>" }
  ],
  "tools": [
    { "type": "mcp_toolset", "mcp_server_name": "seoparse" }
  ]
}

VS Code / Copilot

Файл .mcp.json (або ~/.copilot/mcp-config.json):

{
  "servers": {
    "seoparse": {
      "type": "http",
      "url": "https://seoparse.site/mcp",
      "headers": { "Authorization": "Bearer <ВАШ_ТОКЕН>" }
    }
  }
}

Gemini CLI

Файл ~/.gemini/settings.json:

{
  "mcpServers": {
    "seoparse": {
      "httpUrl": "https://seoparse.site/mcp",
      "headers": { "Authorization": "Bearer <ВАШ_ТОКЕН>" }
    }
  }
}

claude.ai / ChatGPT connectors (OAuth-підключення без ручного токена) — після впровадження OAuth (фаза 4 плану MCP).

Scopes і безпека

Ефективні права виклику завжди дорівнюють перетину прав вашого користувача і scope'ів токена: токен ніколи не підвищує роль і не обходить обмеження облікового запису (наприклад, заборону на парсинг). Доступні scope'и:

• read — читання даних (URL, контент, SERP, задачі, токени).
• write — зміни без витрати бюджету (видача токенів, скасування задач).
• analyze — дії, що витрачають бюджет SERP/AI (Bright Data, AI-перезапис).
• delete — незворотні дії (відкликання токенів тощо).

Деструктивні тули (позначені прапорцем «⚠️ Потребує confirm=true» у довіднику нижче) вимагають явного аргументу confirm: true — без нього виклик відхиляється помилкою confirm_required.

Задачі та прогрес

Довгі операції (парсинг, SERP-аналіз, перезапис сторінки) не блокують виклик — тул одразу повертає job_id. Прогрес і результат читаються тулами get_job / list_jobs (статус, лічильники, повідомлення поточного кроку). Скасування (cancel_job) — кооперативне: задача перевіряє прапорець скасування між кроками (URL/батчами), тож негайної миттєвої зупинки протокол не гарантує.

Квота, ліміти й помилки

Усі помилки API повертаються в одному форматі з кодом, повідомленням і ідентифікатором запиту:

Довідник тулів

Усього доступно тулів через MCP: 58. Кожен тул відповідає рівно одному ендпоінту /api/v1.

account

analysis

content

gsc

health

jobs

manage

me

parse

rewrite

rewrite_manage

rules

tokens

urls