Перейти к содержимому

Ghoster AI 3.6.6 — аккаунт, подписка и личный кабинет

API, MCP и скилл для агента

Подключите Codex, Claude Code или Cursor к трекеру откликов и сохранённым встречам Ghoster AI

Через MCP и REST API ИИ-агент вроде Codex, Claude Code или Cursor может вести ваш трекер откликов и читать сохранённые встречи. Например: «перенеси карточку Ozon в Финалы», «покажи воронку за месяц», «разбери мои ответы на последнем собеседовании». Для работы нужна активная подписка.

1. Создайте токен

На Ghoster AI откройте Аккаунт → Интеграции и нажмите Создать токен . Задайте название, права и срок действия, по умолчанию 90 дней.

ПравоЧто даёт
Чтение трекераДоска, карточки, архив, статистика и напоминания. Сюда же входят названия, оценки и вердикт прикреплённых к карточкам встреч.
Изменение трекераСоздание, правка, перенос, архивация и удаление карточек и колонок, прикрепление встреч к карточкам. Включает чтение трекера.
Чтение встреч, итогов и транскриптовСписок встреч, их итоги и полная расшифровка с перепиской.
  • Токен показывается один раз: скопируйте его сразу.
  • Заводите отдельный токен на каждое приложение. Так любой из них можно отозвать, не трогая остальные, и отзыв действует сразу.
  • Агент видит только инструменты, на которые у токена есть права.
  • Если подписка закончится, токены перестанут работать и заработают снова после продления.

2. Подключите MCP

Передайте токен в переменной окружения GHOSTER_API_TOKEN процессу клиента. В сам файл конфигурации токен не записывайте. Затем добавьте конфигурацию и перезапустите клиент. Эти же конфигурации есть на странице «Интеграции».

Codex: ~/.codex/config.toml

[ mcp_servers . ghoster ] url = "https://backend.ghoster.ai/mcp" bearer_token_env_var = "GHOSTER_API_TOKEN" Claude Code: .mcp.json в корне проекта { "mcpServers" : { "ghoster" : { "type" : "http" , "url" : "https://backend.ghoster.ai/mcp" , "headers" : { "Authorization" : "Bearer ${GHOSTER_API_TOKEN}" } } } } Cursor: ~/.cursor/mcp.json { "mcpServers" : { "ghoster" : { "url" : "https://backend.ghoster.ai/mcp" , "headers" : { "Authorization" : "Bearer ${env:GHOSTER_API_TOKEN}" } } } } 3. Установите скилл Скилл объясняет агенту, как правильно работать с трекером и встречами Ghoster AI: в каком порядке вызывать инструменты, как читать длинные расшифровки и как не создать дубликаты. Один файл подходит для всех трёх клиентов. Скачайте SKILL.md , сохраните его по пути ниже и перезапустите клиент.

КлиентКуда сохранить
Codex~/.agents/skills/ghoster-ai/SKILL.md
Claude Code~/.claude/skills/ghoster-ai/SKILL.md
Cursor~/.cursor/skills/ghoster-ai/SKILL.md

Что может агент

С трекером агент может всё то же, что вы делаете руками: читать доску, карточки, архив и статистику, выгружать статистику в PDF, создавать и менять карточки и колонки, переносить карточки между этапами, прикреплять встречи и настраивать напоминания.

Встречи агент только читает: список, итоги и расшифровку всех подчатов, включая сообщения до сброса контекста. Создавать и удалять встречи, запускать генерацию итогов, работать с заметками и контекстами он не может. Изображения, видео, рассуждения модели и вызовы инструментов через API не отдаются.

Чтение ничего не меняет: пустая доска сама не создаётся, недостающие итоги не генерируются. Чтобы завести доску с этапами по умолчанию и карточками из уже проведённых встреч с вакансиями, у агента есть отдельная команда tracker_initialize .

Удаление карточки стирает её историю и убирает её из статистики воронки, прикреплённые встречи при этом сохраняются. Если карточка просто больше не нужна на доске, её лучше архивировать.

REST API

MCP и REST построены на одних и тех же операциях. Полное описание: OpenAPI .

curl --fail-with-body --silent --show-error \ -H "Authorization: Bearer $GHOSTER_API_TOKEN " \ https://backend.ghoster.ai/api/v1/tracker/board Чтение трекера MCP REST tracker_get_board GET /tracker/board tracker_list_columns GET /tracker/columns tracker_list_cards , tracker_get_card GET /tracker/cards , GET /tracker/cards/{id} tracker_list_archive GET /tracker/archive tracker_get_settings GET /tracker/settings tracker_get_stats , tracker_export_stats_pdf GET /tracker/stats , GET /tracker/stats/pdf Изменение трекера MCP REST tracker_initialize POST /tracker/initialize tracker_create_card , tracker_update_card POST /tracker/cards , PATCH /tracker/cards/{id} tracker_move_card , tracker_archive_card PATCH /tracker/cards/{id}/move , PATCH /tracker/cards/{id}/archive tracker_delete_card DELETE /tracker/cards/{id} tracker_create_column , tracker_update_column POST /tracker/columns , PUT /tracker/columns/{id} tracker_reorder_columns , tracker_delete_column PATCH /tracker/columns/reorder , DELETE /tracker/columns/{id} tracker_attach_meeting , tracker_detach_meeting POST /tracker/cards/{id}/meetings , DELETE /tracker/cards/{id}/meetings/{meetingId} tracker_update_settings PUT /tracker/settings Чтение встреч MCP REST list_meetings , get_meeting GET /meetings , GET /meetings/{id} get_meeting_summary , get_meeting_transcript GET /meetings/{id}/summary , GET /meetings/{id}/transcript Ошибки и лимиты Код Что значит 401 Токен неверный, просрочен или отозван. 403 У токена нет нужного права или закончилась подписка. 404 Объект не найден. Чужие объекты тоже отвечают 404. 409 Повтор с тем же ключом, но другим телом запроса, или расшифровка изменилась во время чтения. Во втором случае прочитайте её заново, когда встреча закончит обрабатываться. 429 Больше 120 запросов в минуту на токен или 600 на аккаунт. Повторите запрос через время из заголовка Retry-After . В MCP ошибки самих инструментов приходят не HTTP-кодом, а текстом результата, например {"error":"card_not_found"} .

Создание карточки и колонки принимает requestId или заголовок Idempotency-Key . Если повторить запрос с тем же ключом в течение 24 часов, вернётся прежний результат, и дубликат не появится.

Готовы попробовать? Установка занимает пару минут, аккаунт не нужен.

Скачать