MCP-сервер

Подключение

Другие клиенты

Любой клиент, который поддерживает Streamable HTTP, подключается так же, с URL и заголовком Authorization. Проверить сервер можно в MCP Inspector.

npx @modelcontextprotocol/inspector --cli https://gemlead.ai/mcp \
  --transport http \
  --header "Authorization: Bearer $GEMLEAD_API_KEY" \
  --method tools/list

Несколько аккаунтов X

Одно подключение работает с одним аккаунтом X. Чтобы работать с несколькими сразу, добавьте Gemlead отдельно для каждого аккаунта, каждый раз со своим URL сервера, то есть https://gemlead.ai/mcp/ и выбранное вами имя, например https://gemlead.ai/mcp/acme и https://gemlead.ai/mcp/julien. Имя служит только меткой и состоит из букв, цифр, - и _.

Подключите каждый и выберите его аккаунт X на странице согласия Gemlead. Если имя совпадает с именем пользователя аккаунта в X, аккаунт выбирается автоматически. Если аккаунты привязаны к разным логинам Gemlead, перед подключением войдите в нужный.

Каждое подключение читает и действует только в своём аккаунте и сообщает ассистенту его @handle, поэтому DM всегда уходит с того аккаунта, который вы указали. Называйте каждый коннектор по его аккаунту, например Gemlead Acme, чтобы различать их в чате.

Инструменты

Инструментов на сервере 67, по одному на каждое действие API. Инструменты чтения только читают. Инструменты записи меняют данные или действуют в X от имени вашего аккаунта, поэтому им нужно право write, а ассистент спрашивает вас, прежде чем что-то отправить, запустить или удалить.

Нажмите на метку MCP у эндпоинта в справочнике API, чтобы перейти к его инструменту.

Ни один инструмент намеренно не задаёт и не удаляет код X Chat, чтобы код никогда не проходил через чат с ИИ. Задайте его в приложении или запросом Установка кода X Chat.

Аргументы и результаты

• Инструмент принимает параметры своего эндпоинта, а ID называются по своему объекту, например lead_id, persona_id, campaign_id, conversation_id или export_id. Списки разбиваются на страницы с limit и cursor, как описано в разделе Пагинация.
• Инструмент, который выполняет несколько действий, принимает action, kind или status, например lead_action с action, равным rescore, refresh, follow или unfollow.
• list_campaigns принимает status в виде массива из draft, active, paused и archived. get_campaign_stats считает от from до to, оба в формате ISO 8601, по умолчанию to равно текущему моменту, а from на 30 дней раньше.
• create_export принимает фильтры search_leads в filters, без limit и cursor. С type, равным conversations, экспортируются все диалоги в DM с полной перепиской, а filters принимает persona_id и unread. Он работает с ключом read, как и Создание экспорта.
• ask_julien_ai отправляет text в Julien AI, а с chat_id продолжает разговор в чате. Ответ, на который уходит больше 25 секунд, возвращается со статусом running и своим id. Вызовите инструмент снова, указав только reply_id с этим значением, и он подождёт ещё до 25 секунд.
• get_conversation и list_messages перечисляют медиафайлы каждого сообщения с их url. view_media принимает url изображения или GIF и показывает ассистенту само изображение, чтобы он мог прочитать скриншот, присланный лидом. send_message отправляет медиафайл в media, в виде публичного https-url или data в base64 с mime_type.
• Неверный аргумент возвращается как ошибка инструмента с его названием. Ошибка API возвращается как ошибка инструмента с её кодом и аргументом, к которому она относится.

Каждый инструмент отвечает JSON своего эндпоинта, в виде структурированного содержимого и в виде текста. Инструменты не публикуют схему вывода, все объекты описаны в справочнике API.

На тарифах Free и Starter сервер устанавливается и показывает свои инструменты, а каждый вызов возвращает ошибку plan_required, которую ассистент может объяснить. Вызовы инструментов учитываются в лимите ключа 120 запросов в минуту, общем с REST API.

Примеры промптов

• Покажи сегодняшних горячих лидов моей персоны «Капперы» и объясни, почему каждый получил высокую оценку.
• У какой кампании была лучшая доля ответов за последние 30 дней и сколько DM она отправила?
• Покажи мои непрочитанные диалоги и кратко опиши, чего хочет каждый лид.
• Выгрузи в CSV всех горячих лидов, найденных на этой неделе, и дай мне ссылку.
• Выгрузи все мои диалоги в DM, а потом скажи, какие первые сообщения получают больше всего ответов и как лиды реагируют на цену.
• Отметь лида @jane_builds как закрытого и сохрани в его метаданных HubSpot ID hs_48213.
• Включи Sam AI в режиме «Полуавто» для моей персоны «Капперы» и добавь наш PDF с ценами к тому, что он читает.

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

• Ассистент видит только тот аккаунт X, который вы подключили.
• Отозвать подключение или ключ можно в любой момент в приложении, в разделе API.
• Давайте ключ read ассистенту, которому нужно только читать.
• Ассистента можно обмануть текстом, который он читает. Проверяйте, что собирается сделать инструмент записи, прежде чем разрешить действие.