# MCP-сервер Linkovod.ru

MCP (Model Context Protocol) сервер позволяет AI-ассистентам управлять проектами и заданиями на
размещение ссылок напрямую. При использовании API/MCP пользователь сам управляет размещением ссылок,
без участия алгоритма Linkovod: сам выбирает поисковые запросы, типы ссылок, скорость размещения —
либо поручает планирование ссылочной стратегии ИИ-агенту.

## Подключение
Endpoint: https://linkovod.ru/api/v1/mcp
Авторизация: заголовок `Authorization: Bearer <API_KEY>` (ключ выдаётся в личном кабинете)

Поддерживаемые клиенты: OpenCode, Claude Desktop, Claude Code, Cursor IDE, GitHub Copilot, Windsurf, Codex, Cline

Конфигурация (Claude Desktop / Claude Code, `claude_desktop_config.json`):
{
  "mcpServers": {
    "linkovod": {
      "url": "https://linkovod.ru/api/v1/mcp",
      "headers": { "Authorization": "Bearer <API_KEY>" }
    }
  }
}

Схему каждого инструмента (параметры, допустимые значения языков, типов ссылок, статусов и т.д.)
агент получает напрямую от MCP-сервера — передавать их вручную не требуется.

## Инструменты

- get_user_info — данные аккаунта: id, email, имя, баланс. Без параметров.
- create_project — создать проект. Параметры: url (обязателен), name (необязателен, название для удобства)
- create_task — создать задание на ссылку, списывает деньги с баланса сразу. Параметры: projectId (обязателен), keyword (обязателен), url (обязателен)
- delete_task — удалить ещё не взятое в работу задание с возвратом денег. Параметры: taskId (обязателен)
- delete_project — удалить проект без размещённых ссылок. Параметры: projectId (обязателен)
- update_project — изменить максимальную цену за крауд-ссылку. Параметры: projectId (обязателен), maxCrowdPrice (обязателен)
- get_task_status — подробная информация по одному заданию. Параметры: taskId (обязателен)
- get_project_status — подробная информация по одному проекту. Параметры: projectId (обязателен)
- reject_task — отправить выполненное задание на доработку в течение гарантийного срока. Параметры: taskId (обязателен), reason (обязателен)
- get_project_tasks — список заданий проекта с пагинацией и фильтром по статусу. Параметры: projectId (обязателен), page (по умолчанию 1), limit (по умолчанию 10), status (опционален)
- get_projects — список всех проектов пользователя со статистикой. Без параметров.
- get_user_transactions — сводка по транзакциям, сгруппированная по типам, за период. Параметры: from (по умолчанию 30 дней назад), to (по умолчанию сегодня)