MCP-сервер Gptalk AI

Подключите Gptalk AI к своему ИИ-ассистенту — Claude, ChatGPT, Codex, Cursor или любому клиенту Model Context Protocol — и создавайте, настраивайте и проверяйте ИИ-агентов обычными словами в чате.

Адрес сервера: https://api.gptalkai.ru/mcp

Ассистент получает 53 инструментов: читает настройки агента, базу знаний, инструменты, интеграции и диалоги с клиентами; создаёт агентов, пополняет базу знаний, подключает каналы и CRM, исправляет ответы агента. Всё, что ассистент делает, записывается в журнал агента.

Транспорт	Streamable HTTP, без состояния (stateless), ответы JSON
Протокол	MCP 2025-06-18 и новее
Авторизация	OAuth 2.1 (вход через Telegram) или API-ключ в заголовке `Authorization: Bearer`
Версия сервера	1.0.0
REST API	Те же операции по HTTP: документация REST API

Подключение

Есть два способа авторизации:

OAuth — клиент сам откроет страницу входа, вы войдёте через Telegram и разрешите доступ. Ключ не нужен. Так работают claude.ai, Claude Desktop и ChatGPT.
API-ключ — для клиентов, где удобно указать заголовок: Claude Code, Codex, Cursor, VS Code, свои скрипты. Ключ создаётся в боте: команда /api → «Открыть API и MCP» → «Создать ключ».

claude.ai и Claude Desktop

Откройте Настройки → Коннекторы (Settings → Connectors) и нажмите Добавить свой коннектор.
Название — Gptalk AI, адрес — https://api.gptalkai.ru/mcp.
Нажмите Подключить. Откроется страница Gptalk AI: войдите через Telegram или через бота и нажмите «Разрешить».
В чате включите коннектор в меню инструментов и попросите, например: «Покажи моих агентов Gptalk».

Claude Code

С API-ключом:

claude mcp add --transport http gptalk https://api.gptalkai.ru/mcp \
  --header "Authorization: Bearer gtk_live_..."

Через OAuth: добавьте сервер без заголовка, затем в Claude Code выполните /mcp → gptalk → Authenticate.

claude mcp add --transport http gptalk https://api.gptalkai.ru/mcp

ChatGPT

Включите режим разработчика: Settings → Apps & Connectors → Advanced → Developer mode.
Create → адрес https://api.gptalkai.ru/mcp, аутентификация OAuth.
Войдите через Telegram и разрешите доступ. В новом чате выберите коннектор Gptalk AI.

Codex

Добавьте в ~/.codex/config.toml:

[mcp_servers.gptalk]
url = "https://api.gptalkai.ru/mcp"
bearer_token_env_var = "GPTALK_API_KEY"

И задайте ключ в окружении: export GPTALK_API_KEY="gtk_live_...". Без ключа можно войти через OAuth: codex mcp login gptalk.

Cursor

Файл ~/.cursor/mcp.json (или .cursor/mcp.json в проекте):

{
  "mcpServers": {
    "gptalk": {
      "url": "https://api.gptalkai.ru/mcp",
      "headers": { "Authorization": "Bearer gtk_live_..." }
    }
  }
}

Без заголовка headers Cursor предложит войти через OAuth.

VS Code (GitHub Copilot)

Файл .vscode/mcp.json:

{
  "servers": {
    "gptalk": {
      "type": "http",
      "url": "https://api.gptalkai.ru/mcp",
      "headers": { "Authorization": "Bearer ${input:gptalk-key}" }
    }
  },
  "inputs": [
    { "id": "gptalk-key", "type": "promptString", "description": "API-ключ Gptalk AI", "password": true }
  ]
}

Другие клиенты и проверка

Любой клиент с поддержкой Streamable HTTP подключается по адресу https://api.gptalkai.ru/mcp. Клиенту только с stdio поможет прокси mcp-remote:

npx -y mcp-remote https://api.gptalkai.ru/mcp --header "Authorization: Bearer gtk_live_..."

Проверить сервер вручную можно в MCP Inspector:

npx @modelcontextprotocol/inspector

Transport — Streamable HTTP, URL — https://api.gptalkai.ru/mcp, заголовок Authorization: Bearer gtk_live_....

Авторизация

OAuth 2.1

Сервер — защищённый ресурс OAuth 2.1 по спецификации MCP Authorization. Клиент без токена получает 401 с заголовком WWW-Authenticate, находит сервер авторизации и проходит вход:

Метаданные ресурса (RFC 9728)	`https://api.gptalkai.ru/.well-known/oauth-protected-resource/mcp`
Метаданные сервера (RFC 8414)	`https://api.gptalkai.ru/.well-known/oauth-authorization-server`
Регистрация клиента (RFC 7591)	`POST https://api.gptalkai.ru/oauth/register`
Авторизация	`https://api.gptalkai.ru/oauth/authorize` — Authorization Code + PKCE S256
Токен	`POST https://api.gptalkai.ru/oauth/token` — access token на 1 час, refresh token на 30 дней с ротацией
Отзыв (RFC 7009)	`POST https://api.gptalkai.ru/oauth/revoke`

Вход — через виджет Telegram или подтверждением в боте Gptalk AI. Подключённые приложения видны и отключаются в боте: /api → «Подключённые приложения».

API-ключ

Ключ gtk_live_… передаётся в заголовке Authorization: Bearer. Ключ показывается один раз; храните его как пароль. Ключ с доступом «Только чтение» не может ничего изменить.

Права

Токен действует от имени пользователя: доступны его агенты и агенты, в команду которых он входит. Сотрудник ограничен правами своей роли. Права токена:

Право	Что разрешает
`agents:read`	Читать агентов, их настройки, системный промпт и журнал
`agents:write`	Создавать агентов, менять настройки, останавливать и запускать
`knowledge:read`	Читать базу знаний и материалы
`knowledge:write`	Добавлять, менять и удалять документы и материалы
`tools:read`	Читать инструменты и переменные
`tools:write`	Создавать, менять, проверять и удалять инструменты и переменные
`channels:read`	Читать подключённые каналы
`channels:write`	Подключать, настраивать и отключать каналы
`integrations:read`	Читать интеграции (CRM, календарь, встречи)
`integrations:write`	Подключать, настраивать, проверять и отключать интеграции
`dialogs:read`	Читать диалоги агента с клиентами
`corrections:read`	Читать исправления ответов агента
`corrections:write`	Создавать, менять и удалять исправления ответов

Примеры задач

Пишите ассистенту обычными словами. Например:

«Создай агента-администратора для салона красоты „Лиса“: записывает на стрижки и окрашивание, цены — в приложенном прайсе».
«Добавь в базу знаний агента 12 график работы на праздники».
«Посмотри последние 20 диалогов агента и найди, где он ошибся. Предложи исправления».
«Почему агент не нашёл цену на ламинирование? Проверь поиск по базе знаний».
«Подключи агенту Telegram-бота, вот токен: …».
«Сделай HTTP-инструмент, который проверяет свободные окна в нашей CRM по API, токен — в переменной».
«Включи дожим: напоминать молчащим клиентам через 2 часа и через сутки».

Готовые сценарии есть и в виде промптов MCP: design_agent и audit_agent.

Справочник инструментов

У каждого инструмента есть JSON-схема входа и выхода (structured output) и подсказки: чтение — ничего не меняет, изменение, удаление — необратимо, внешний вызов — обращается к стороннему сервису.

Аккаунт и агенты

`get_account` — Аккаунт

чтениеправо: любое

Аккаунт владельца токена: тариф, AI-бюджет, доступы и права токена.

Без параметров.

`get_usage` — Расход AI-бюджета

чтениеправо: agents:read

Запросы к модели, токены и стоимость по агентам за период (по умолчанию 30 дней).

Параметр	Тип	Описание
`date_from`	datetime \| null	ISO 8601
`date_to`	datetime \| null	ISO 8601
`agent_id`	integer \| null

`list_agents` — Список агентов

чтениеправо: agents:read

Агенты пользователя и агенты, где он в команде (role). Начните работу с этого.

Параметр	Тип	Описание
`limit`	integer \| null	Размер страницы
`cursor`	string \| null	next_cursor предыдущей страницы

`get_agent_overview` — Сводка по агенту

чтениеправо: agents:read

Всё о настройке агента одним вызовом: настройки, база знаний, инструменты, переменные, каналы, интеграции, исправления, диалоги и что настроить дальше.

Параметр	Тип	Описание
`agent_id` обязательно	integer	ID агента из list_agents

`get_agent` — Настройки агента

чтениеправо: agents:read

Полные настройки агента: компания, персона, цель, instructions, тон, график, дожим.

Параметр	Тип	Описание
`agent_id` обязательно	integer	ID агента из list_agents

`create_agent` — Создать агента

изменениеправо: agents:write

Создаёт агента. Обязательны company_name, company_description, persona_name, job_title, goal. Добавьте instructions — как вести диалог, что предлагать, когда передавать менеджеру. Данные компании берите у пользователя, не выдумывайте.

Параметр	Тип	Описание
`agent` обязательно	AgentCreate

AgentCreate

A new agent. ``name`` defaults to «persona_name — company_name».

Поле	Тип	Описание
`company_name` обязательно	string
`company_description` обязательно	string
`persona_name` обязательно	string	Имя агента для клиентов
`job_title` обязательно	string	Должность агента
`goal` обязательно	string	Конечная цель диалога
`name`	string \| null	Название в списке агентов
`instructions`	string	Инструкции: как вести диалог
`limitations`	string
`tone`	string
`frequently_asked_questions`	string
`client_data_fields`	"name" \| "phone" \| "email" \| "telegram" \| "delivery_address" \| "city" \| "age"[]
`work_schedule`	WorkDay[] \| null
`follow_up`	object \| null

`update_agent` — Изменить агента

изменениеправо: agents:write

Меняет только переданные поля настроек агента. follow_up сливается с текущими настройками (например {"enabled": true}); work_schedule — 7 дней с понедельника.

Параметр	Тип	Описание
`agent_id` обязательно	integer	ID агента из list_agents
`changes` обязательно	AgentUpdate

AgentUpdate

Partial update: only the fields present are changed (JSON Merge Patch).

Поле	Тип	Описание
`name`	string \| null
`company_name`	string \| null
`company_description`	string \| null
`persona_name`	string \| null
`job_title`	string \| null
`goal`	string \| null
`instructions`	string \| null
`limitations`	string \| null
`tone`	string \| null
`frequently_asked_questions`	string \| null
`client_data_fields`	"name" \| "phone" \| "email" \| "telegram" \| "delivery_address" \| "city" \| "age"[] \| null
`work_schedule`	WorkDay[] \| null
`follow_up`	object \| null

`pause_agent` — Остановить агента

изменениеправо: agents:write

Агент перестаёт отвечать во всех каналах; подключения сохраняются. Только владелец.

Параметр	Тип	Описание
`agent_id` обязательно	integer	ID агента из list_agents

`resume_agent` — Запустить агента

изменениеправо: agents:write

Возвращает агента в каналы. Требует оплаченного доступа. Только владелец.

Параметр	Тип	Описание
`agent_id` обязательно	integer	ID агента из list_agents

`get_system_prompt` — Системный промпт

чтениеправо: agents:read

Системный промпт, который модель получает из настроек агента.

Параметр	Тип	Описание
`agent_id` обязательно	integer	ID агента из list_agents

`get_team` — Команда агента

чтениеправо: agents:read

Сотрудники агента и права ролей. Только владелец.

Параметр	Тип	Описание
`agent_id` обязательно	integer	ID агента из list_agents

`list_activity` — Журнал действий

чтениеправо: agents:read

Вызовы инструментов, ошибки и изменения настроек агента — новые сначала.

Параметр	Тип	Описание
`agent_id` обязательно	integer	ID агента из list_agents
`limit`	integer \| null	Размер страницы
`cursor`	string \| null	next_cursor предыдущей страницы
`event_type`	string \| null	tool_call, connection_check, agent_settings_updated…
`conversation_id`	integer \| null

База знаний и файлы

`list_knowledge` — База знаний

чтениеправо: knowledge:read

Документы базы знаний агента без текста. Текст — get_knowledge_document.

Параметр	Тип	Описание
`agent_id` обязательно	integer	ID агента из list_agents
`limit`	integer \| null	Размер страницы
`cursor`	string \| null	next_cursor предыдущей страницы

`get_knowledge_document` — Документ базы знаний

чтениеправо: knowledge:read

Документ базы знаний с полным текстом.

Параметр	Тип	Описание
`agent_id` обязательно	integer	ID агента из list_agents
`document_id` обязательно	integer

`add_knowledge_text` — Добавить текст в базу знаний

изменениеправо: knowledge:write

Добавляет факты, по которым агент отвечает: цены, условия, описание услуг, адреса, график. Один документ — одна тема, с понятным заголовком.

Параметр	Тип	Описание
`agent_id` обязательно	integer	ID агента из list_agents
`content` обязательно	string
`title`	string \| null

`add_knowledge_file` — Загрузить файл в базу знаний

изменениеправо: knowledge:write

Загружает документ (PDF, DOCX, XLSX, PPTX, TXT, MD…), извлекает и индексирует текст.

Параметр	Тип	Описание
`agent_id` обязательно	integer	ID агента из list_agents
`file_name` обязательно	string	Имя с расширением: price.pdf
`content_base64` обязательно	string	Содержимое файла в base64, до 20 МБ

`update_knowledge_document` — Изменить документ

изменениеправо: knowledge:write

Заменяет текст документа (с переиндексацией) и/или заголовок.

Параметр	Тип	Описание
`agent_id` обязательно	integer	ID агента из list_agents
`document_id` обязательно	integer
`content`	string \| null
`title`	string \| null

`delete_knowledge_document` — Удалить документ

удалениеправо: knowledge:write

Удаляет документ из базы знаний безвозвратно.

Параметр	Тип	Описание
`agent_id` обязательно	integer	ID агента из list_agents
`document_id` обязательно	integer

`search_knowledge` — Поиск по базе знаний

чтениеправо: knowledge:read

Ищет так же, как агент в разговоре. Помогает понять, найдёт ли агент ответ.

Параметр	Тип	Описание
`agent_id` обязательно	integer	ID агента из list_agents
`query` обязательно	string

`list_materials` — Файлы для клиентов

чтениеправо: knowledge:read

Файлы, которые агент отправляет клиентам по описанию (прайсы, презентации, фото).

Параметр	Тип	Описание
`agent_id` обязательно	integer	ID агента из list_agents

`add_material` — Загрузить файл для клиентов

изменениеправо: knowledge:write

clients — агент отправляет файл клиентам по описанию; answers — текст файла идёт в базу знаний; both — оба варианта.

Параметр	Тип	Описание
`agent_id` обязательно	integer	ID агента из list_agents
`file_name` обязательно	string
`content_base64` обязательно	string	Содержимое файла в base64, до 20 МБ
`description`	string	Когда агенту отправлять файл
`purpose`	"clients" \| "answers" \| "both"

`update_material` — Изменить описание файла

изменениеправо: knowledge:write

Меняет описание: по нему агент решает, когда отправить файл клиенту.

Параметр	Тип	Описание
`agent_id` обязательно	integer	ID агента из list_agents
`material_id` обязательно	integer
`description` обязательно	string

`delete_material` — Удалить файл

удалениеправо: knowledge:write

Удаляет файл для клиентов безвозвратно.

Параметр	Тип	Описание
`agent_id` обязательно	integer	ID агента из list_agents
`material_id` обязательно	integer

Инструменты и переменные

`list_builtin_tools` — Встроенные инструменты

чтениеправо: tools:read

Инструменты платформы, которые есть у каждого агента без настройки.

Без параметров.

`list_tools` — Инструменты агента

чтениеправо: tools:read

Свои HTTP- и Python-инструменты агента с конфигурацией и статусом проверки.

Параметр	Тип	Описание
`agent_id` обязательно	integer	ID агента из list_agents

`get_tool` — Инструмент

чтениеправо: tools:read

Один инструмент с конфигурацией (секретные значения скрыты).

Параметр	Тип	Описание
`agent_id` обязательно	integer	ID агента из list_agents
`tool_id` обязательно	integer

`create_tool` — Создать инструмент

изменениеправо: tools:write

HTTP-инструмент: config = {method, url, query[], headers[], body_mode, body_fields[], raw_body, timeout}; элемент — {key, value_source: fixed|agent|template, value, variable, description}. Секреты — через переменные: value_source=template, value="Bearer {{API_TOKEN}}". Python-инструмент: config = {inputs[], outputs[], code}. После создания предложите проверить его (check_tool).

Параметр	Тип	Описание
`agent_id` обязательно	integer	ID агента из list_agents
`tool` обязательно	ToolCreate

ToolCreate

``config`` follows the HTTP or Python tool schema, see the documentation.

Поле	Тип	Описание
`type` обязательно	"http" \| "python"
`name` обязательно	string	snake_case, уникально у агента
`display_name` обязательно	string
`description` обязательно	string	Когда и зачем агенту вызывать инструмент
`config` обязательно	object

`update_tool` — Изменить инструмент

изменениеправо: tools:write

Меняет поля инструмента. config передаётся целиком; без config он не меняется.

Параметр	Тип	Описание
`agent_id` обязательно	integer	ID агента из list_agents
`tool_id` обязательно	integer
`changes` обязательно	ToolUpdate

ToolUpdate

Поле	Тип	Описание
`name`	string \| null
`display_name`	string \| null
`description`	string \| null
`config`	object \| null	Полная новая конфигурация (заменяет прежнюю)

`delete_tool` — Удалить инструмент

удалениеправо: tools:write

Удаляет инструмент агента безвозвратно.

Параметр	Тип	Описание
`agent_id` обязательно	integer	ID агента из list_agents
`tool_id` обязательно	integer

`check_tool` — Проверить инструмент

внешний вызовправо: tools:write

Реально вызывает инструмент с тестовыми параметрами (внешний сервис выполнит действие). Перед вызовом получите согласие пользователя.

Параметр	Тип	Описание
`agent_id` обязательно	integer	ID агента из list_agents
`tool_id` обязательно	integer
`arguments`	object	Тестовые входные параметры
`confirmed_real_execution`	boolean	Пользователь подтвердил реальный вызов

`list_variables` — Переменные

чтениеправо: tools:read

Глобальные переменные агента для инструментов. Значения секретов не выдаются.

Параметр	Тип	Описание
`agent_id` обязательно	integer	ID агента из list_agents

`set_variable` — Задать переменную

изменениеправо: tools:write

Создаёт переменную или обновляет существующую с тем же именем.

Параметр	Тип	Описание
`agent_id` обязательно	integer	ID агента из list_agents
`name` обязательно	string	Например API_TOKEN
`description`	string \| null
`value`	string \| null
`is_secret`	boolean \| null

`delete_variable` — Удалить переменную

удалениеправо: tools:write

Удаляет переменную. Инструменты, которые на неё ссылаются, перестанут работать.

Параметр	Тип	Описание
`agent_id` обязательно	integer	ID агента из list_agents
`variable_id` обязательно	integer

Каналы

`list_channel_types` — Типы каналов

чтениеправо: channels:read

Какие каналы бывают и какие данные нужны для подключения каждого.

Без параметров.

`list_channels` — Каналы агента

чтениеправо: channels:read

Подключённые каналы агента: статус, аккаунт, код виджета, адрес вебхука VK.

Параметр	Тип	Описание
`agent_id` обязательно	integer	ID агента из list_agents

`connect_channel` — Подключить канал

внешний вызовправо: channels:write

Проверяет данные у провайдера и подключает канал. telegram_bot/max_bot: token; vk_community: group_id, access_token (затем update_channel с confirmation_token); website_chat: origin; avito: client_id, client_secret; wazzup: token, channel_ids. Требует оплаченного доступа агента.

Параметр	Тип	Описание
`agent_id` обязательно	integer	ID агента из list_agents
`channel_type` обязательно	string	telegram_bot, max_bot, vk_community, website_chat, avito, wazzup
`credentials` обязательно	ChannelConnect

ChannelConnect

Credentials of a channel; which fields are required depends on its type.

Поле	Тип	Описание
`token`	string \| null	telegram_bot, max_bot, wazzup
`group_id`	string \| null	vk_community
`access_token`	string \| null	vk_community
`origin`	string \| null	website_chat: https://ваш-сайт
`client_id`	string \| null	avito
`client_secret`	string \| null	avito
`channel_ids`	string[] \| null	wazzup
`replace_webhook`	boolean	wazzup
`pause_on_external`	boolean	wazzup

`update_channel` — Настроить канал

изменениеправо: channels:write

Пауза канала (enabled=false/true), обработка фото и голоса (media_enabled), строка подтверждения Callback API ВКонтакте (confirmation_token).

Параметр	Тип	Описание
`agent_id` обязательно	integer	ID агента из list_agents
`channel_type` обязательно	string
`changes` обязательно	ChannelUpdate

ChannelUpdate

Поле	Тип	Описание
`enabled`	boolean \| null	false — поставить канал на паузу
`media_enabled`	boolean \| null
`confirmation_token`	string \| null	vk_community

`disconnect_channel` — Отключить канал

удалениеправо: channels:write

Отключает канал и удаляет его данные. Агент перестанет отвечать в нём.

Параметр	Тип	Описание
`agent_id` обязательно	integer	ID агента из list_agents
`channel_type` обязательно	string

`inspect_wazzup` — Каналы Wazzup по ключу

чтениеправо: channels:write

Перед подключением Wazzup: доступные по ключу каналы и их channel_id.

Параметр	Тип	Описание
`agent_id` обязательно	integer	ID агента из list_agents
`token` обязательно	string

Интеграции

`list_integration_types` — Типы интеграций

чтениеправо: integrations:read

Доступные интеграции и какие данные нужны для подключения.

Без параметров.

`list_integrations` — Интеграции агента

чтениеправо: integrations:read

Подключённые CRM, календарь и сервисы встреч со статусом проверки.

Параметр	Тип	Описание
`agent_id` обязательно	integer	ID агента из list_agents

`connect_integration` — Подключить интеграцию

внешний вызовправо: integrations:write

Проверяет доступ у сервиса и подключает его. amocrm: address, token; bitrix24: webhook_url; yandex_calendar: login, app_password; zoom: account_id, client_id, client_secret; yandex_telemost: client_id, access_token.

Параметр	Тип	Описание
`agent_id` обязательно	integer	ID агента из list_agents
`integration_type` обязательно	string	amocrm, bitrix24, yandex_calendar, zoom, yandex_telemost
`credentials` обязательно	IntegrationConnect

IntegrationConnect

Credentials; which fields are required depends on the integration type.

Поле	Тип	Описание
`access_mode`	"read" \| "write" \| null
`account_id`	string \| null	zoom
`client_id`	string \| null	zoom, yandex_telemost
`client_secret`	string \| null	zoom
`access_token`	string \| null	yandex_telemost
`login`	string \| null	yandex_calendar
`app_password`	string \| null	yandex_calendar
`address`	string \| null	amocrm: адрес аккаунта
`token`	string \| null	amocrm: долгосрочный токен
`webhook_url`	string \| null	bitrix24: входящий вебхук

`get_integration_options` — Варианты настроек CRM

чтениеправо: integrations:read

Воронки, этапы, пользователи и поля сделок CRM — чтобы выбрать settings.

Параметр	Тип	Описание
`agent_id` обязательно	integer	ID агента из list_agents
`integration_type` обязательно	string

`update_integration` — Настроить интеграцию

изменениеправо: integrations:write

access_mode (read/write) и для CRM settings: pipeline_id, initial_stage_id, responsible_user_id, allowed_fields, can_close_deals, auto_sync_handoff.

Параметр	Тип	Описание
`agent_id` обязательно	integer	ID агента из list_agents
`integration_type` обязательно	string
`changes` обязательно	IntegrationUpdate

IntegrationUpdate

Поле	Тип	Описание
`access_mode`	"read" \| "write" \| null
`settings`	CRMSettings \| null	Только для amocrm и bitrix24

`check_integration` — Проверить интеграцию

внешний вызовправо: integrations:write

Реальный запрос к сервису; для встреч создаётся тестовая встреча. Спросите пользователя перед вызовом.

Параметр	Тип	Описание
`agent_id` обязательно	integer	ID агента из list_agents
`integration_type` обязательно	string
`arguments`	object	Для встреч: topic, start, end с часовым поясом
`confirmed_real_execution`	boolean

`disconnect_integration` — Отключить интеграцию

удалениеправо: integrations:write

Отключает интеграцию и удаляет её данные.

Параметр	Тип	Описание
`agent_id` обязательно	integer	ID агента из list_agents
`integration_type` обязательно	string

Диалоги

`list_conversations` — Диалоги

чтениеправо: dialogs:read

Диалоги агента с клиентами, свежие сначала, с последним сообщением.

Параметр	Тип	Описание
`agent_id` обязательно	integer	ID агента из list_agents
`limit`	integer \| null	Размер страницы
`cursor`	string \| null	next_cursor предыдущей страницы
`kind`	"clients" \| "test" \| "all"
`channel`	string \| null
`updated_since`	datetime \| null	ISO 8601
`search`	string \| null

`get_conversation` — Диалог

чтениеправо: dialogs:read

Диалог с данными клиента, собранными агентом.

Параметр	Тип	Описание
`agent_id` обязательно	integer	ID агента из list_agents
`conversation_id` обязательно	integer

`list_messages` — Сообщения диалога

чтениеправо: dialogs:read

Сообщения диалога. role=user — клиент, assistant — агент (author_kind=agent) или менеджер (author_kind=human).

Параметр	Тип	Описание
`agent_id` обязательно	integer	ID агента из list_agents
`conversation_id` обязательно	integer
`limit`	integer \| null	Размер страницы
`cursor`	string \| null	next_cursor предыдущей страницы
`order`	"asc" \| "desc"

Исправления ответов

`list_corrections` — Исправления ответов

чтениеправо: corrections:read

Исправления: ситуации, где агент ответил неверно, и правильные ответы.

Параметр	Тип	Описание
`agent_id` обязательно	integer	ID агента из list_agents
`limit`	integer \| null	Размер страницы
`cursor`	string \| null	next_cursor предыдущей страницы

`create_correction` — Добавить исправление

изменениеправо: corrections:write

Учит агента отвечать правильно в похожей ситуации. Укажите message_id ответа агента из list_messages — вопрос клиента и неверный ответ подставятся сами.

Параметр	Тип	Описание
`agent_id` обязательно	integer	ID агента из list_agents
`correction` обязательно	CorrectionCreate

CorrectionCreate

Either give the texts, or ``message_id`` of the agent's reply in a dialog: the client's message and the wrong reply are then taken from the dialog.

Поле	Тип	Описание
`expected_agent_response` обязательно	string
`customer_message`	string \| null
`incorrect_agent_response`	string \| null
`context`	string \| null
`message_id`	integer \| null	ID ответа агента в диалоге
`is_enabled`	boolean

`update_correction` — Изменить исправление

изменениеправо: corrections:write

Меняет тексты исправления или включает/выключает его (is_enabled).

Параметр	Тип	Описание
`agent_id` обязательно	integer	ID агента из list_agents
`correction_id` обязательно	integer
`changes` обязательно	CorrectionUpdate

CorrectionUpdate

Поле	Тип	Описание
`customer_message`	string \| null
`incorrect_agent_response`	string \| null
`expected_agent_response`	string \| null
`context`	string \| null
`is_enabled`	boolean \| null

`delete_correction` — Удалить исправление

удалениеправо: corrections:write

Удаляет исправление безвозвратно.

Параметр	Тип	Описание
`agent_id` обязательно	integer	ID агента из list_agents
`correction_id` обязательно	integer

Ресурсы

Ресурсы можно прикрепить к чату как контекст (в клиентах с поддержкой ресурсов).

URI	Название	Тип	Описание
`gptalk://agents/{agent_id}`	Сводка по агенту	application/json	Настройки и состояние агента (как get_agent_overview).
`gptalk://agents/{agent_id}/system-prompt`	Системный промпт агента	text/plain	Системный промпт агента.
`gptalk://agents/{agent_id}/conversations/{conversation_id}`	Переписка диалога	text/plain	Последние 200 сообщений диалога в виде текста.

Промпты

`design_agent` — Спроектировать агента

Собрать агента по описанию бизнеса.

Аргументы: business (обязательно)

`audit_agent` — Проверить качество агента

Разобрать диалоги агента и предложить улучшения.

Аргументы: agent_id (обязательно), conversations

Ошибки и лимиты

Ошибка инструмента возвращается как результат с isError: true и текстом для ассистента. В конце текста в квадратных скобках — стабильный код ошибки, тот же, что в REST API: not_found, forbidden, insufficient_scope, validation_error, conflict, access_expired, draft_agent, rate_limited, upstream_error. Полный список — в документации REST API.

Лимиты: 300 запросов в минуту на токен, из них не более 60 изменений. Файл в content_base64 — до 20 МБ; большие файлы загружайте через REST API или Mini App.

Безопасность

Токены, ключи CRM и секретные переменные передаются только на вход и никогда не возвращаются в ответах.
Проверка инструментов и интеграций (check_tool, check_integration) выполняет реальный вызов внешнего сервиса и требует confirmed_real_execution=true — ассистент должен спросить вас.
Удаление и отключение помечены destructiveHint: клиенты MCP просят подтверждение.
Подключение каналов и запуск агента требуют оплаченного доступа, как в боте.
Каналы с входом по коду (личный Telegram- и MAX-аккаунт) подключаются только в Mini App.
Каждое изменение пишется в журнал агента с пометкой источника (mcp) и названием ключа или приложения.

MCP-сервер Gptalk AI

Подключение

Авторизация

OAuth 2.1

API-ключ

Права

Примеры задач

Справочник инструментов

Аккаунт и агенты

get_account — Аккаунт

get_usage — Расход AI-бюджета

list_agents — Список агентов

get_agent_overview — Сводка по агенту

get_agent — Настройки агента

create_agent — Создать агента

AgentCreate

update_agent — Изменить агента

AgentUpdate

pause_agent — Остановить агента

resume_agent — Запустить агента

get_system_prompt — Системный промпт

get_team — Команда агента

list_activity — Журнал действий

База знаний и файлы

list_knowledge — База знаний

get_knowledge_document — Документ базы знаний

add_knowledge_text — Добавить текст в базу знаний

add_knowledge_file — Загрузить файл в базу знаний

update_knowledge_document — Изменить документ

delete_knowledge_document — Удалить документ

search_knowledge — Поиск по базе знаний

list_materials — Файлы для клиентов

add_material — Загрузить файл для клиентов

update_material — Изменить описание файла

delete_material — Удалить файл

Инструменты и переменные

list_builtin_tools — Встроенные инструменты

list_tools — Инструменты агента

get_tool — Инструмент

create_tool — Создать инструмент

ToolCreate

update_tool — Изменить инструмент

ToolUpdate

delete_tool — Удалить инструмент

check_tool — Проверить инструмент

list_variables — Переменные

set_variable — Задать переменную

delete_variable — Удалить переменную

Каналы

list_channel_types — Типы каналов

list_channels — Каналы агента

connect_channel — Подключить канал

ChannelConnect

update_channel — Настроить канал

ChannelUpdate

disconnect_channel — Отключить канал

inspect_wazzup — Каналы Wazzup по ключу

Интеграции

list_integration_types — Типы интеграций

list_integrations — Интеграции агента

connect_integration — Подключить интеграцию

IntegrationConnect

get_integration_options — Варианты настроек CRM

update_integration — Настроить интеграцию

IntegrationUpdate

check_integration — Проверить интеграцию

disconnect_integration — Отключить интеграцию

Диалоги

list_conversations — Диалоги

get_conversation — Диалог

list_messages — Сообщения диалога

Исправления ответов

list_corrections — Исправления ответов

create_correction — Добавить исправление

CorrectionCreate

update_correction — Изменить исправление

CorrectionUpdate

delete_correction — Удалить исправление

Ресурсы

Промпты

`get_account` — Аккаунт

`get_usage` — Расход AI-бюджета

`list_agents` — Список агентов

`get_agent_overview` — Сводка по агенту

`get_agent` — Настройки агента

`create_agent` — Создать агента

`update_agent` — Изменить агента

`pause_agent` — Остановить агента

`resume_agent` — Запустить агента

`get_system_prompt` — Системный промпт

`get_team` — Команда агента

`list_activity` — Журнал действий

`list_knowledge` — База знаний

`get_knowledge_document` — Документ базы знаний

`add_knowledge_text` — Добавить текст в базу знаний

`add_knowledge_file` — Загрузить файл в базу знаний

`update_knowledge_document` — Изменить документ

`delete_knowledge_document` — Удалить документ

`search_knowledge` — Поиск по базе знаний

`list_materials` — Файлы для клиентов

`add_material` — Загрузить файл для клиентов

`update_material` — Изменить описание файла

`delete_material` — Удалить файл

`list_builtin_tools` — Встроенные инструменты

`list_tools` — Инструменты агента

`get_tool` — Инструмент

`create_tool` — Создать инструмент

`update_tool` — Изменить инструмент

`delete_tool` — Удалить инструмент

`check_tool` — Проверить инструмент

`list_variables` — Переменные

`set_variable` — Задать переменную

`delete_variable` — Удалить переменную

`list_channel_types` — Типы каналов

`list_channels` — Каналы агента

`connect_channel` — Подключить канал

`update_channel` — Настроить канал

`disconnect_channel` — Отключить канал

`inspect_wazzup` — Каналы Wazzup по ключу

`list_integration_types` — Типы интеграций

`list_integrations` — Интеграции агента

`connect_integration` — Подключить интеграцию

`get_integration_options` — Варианты настроек CRM

`update_integration` — Настроить интеграцию

`check_integration` — Проверить интеграцию

`disconnect_integration` — Отключить интеграцию

`list_conversations` — Диалоги

`get_conversation` — Диалог

`list_messages` — Сообщения диалога

`list_corrections` — Исправления ответов

`create_correction` — Добавить исправление

`update_correction` — Изменить исправление

`delete_correction` — Удалить исправление

`design_agent` — Спроектировать агента

`audit_agent` — Проверить качество агента