Как подключить Clay к ChatGPT через MCP

💡 Без установки? Используйте cloud.anythingmcp.com напрямую. Войдите, нажмите Connectors → Clay, вставьте учётные данные, создайте MCP API key, и готово. Без Docker, без git clone, без локального сервера.

Clay + ChatGPT

GTM-данные Clay из любого AI-агента: поиск по базе людей и компаний Clay, запуск функций обогащения Clay и собственных функций на наборе до 100 элементов, запросы к таблицам Clay на тарифах Enterprise, поиск запусков Workflow и проверка баланса кредитов. Работает с личным API-ключом Clay; удаление по запросу о персональных данных отключено при установке.

Предварительные требования

Полные инструкции по настройке встроены в коннектор (видны в магазине при выборе коннектора). Требуемые переменные окружения:

CLAY_API_KEY

Шаг 1 — Получите учётные данные

Настройка занимает около 2 минут. Нужен аккаунт Clay.

1. В Clay откройте API and CLI, вкладку API keys (https://app.clay.com/workspaces/~/api-and-cli?tab=api-keys), и создайте ключ. Ключ действует от имени вашего пользователя, с вашим доступом к рабочему пространству.
2. Вставьте его в CLAY_API_KEY. Он отправляется в заголовке clay-api-key.
3. Для собственных функций откройте функцию в Clay, затем Details, и включите доступ API; скопируйте её id t_....
4. Установите коннектор и запустите clay_get_me: он вернёт пользователя и рабочее пространство и подтвердит ключ. clay_get_credit_balance показывает оставшиеся кредиты; чтение баланса кредиты не тратит.

Поиск по базе людей и компаний:

1. clay_get_search_query_reference один раз за сессию даёт доступные для поиска поля людей и компаний, операторы и грамматику.
2. clay_create_search запускает поиск по запросу, начинающемуся с select from people или select from companies, например select from companies where people.exists(is_current = true and job_title is_similar_to ("VP Sales")), и возвращает search_id. Запросы на подсчёт и поиск вакансий не поддерживаются.
3. clay_get_search_results с этим id работает как итератор с состоянием: каждый вызов возвращает следующую страницу, и ИИ вызывает его снова, пока has_more равно true. Люди приходят с именем, местоположением и подходящими местами работы; компании с доменом, отраслью, размером, выручкой и URL LinkedIn.

Результаты поиска учитываются в лимитах вашего тарифа: на бесплатном 50 за поиск и 100 за 30 дней, на платных 500 за запрос. При превышении лимита Clay отвечает 402 и называет лимит.

Обогащение функцией:

1. clay_run_routine запускает функцию Clay или собственную функцию с доступом API на 1-100 элементах: id рутины (function:t_...) и элементы вида {"id": "row-1", "inputs": {"domain": "clay.com"}}. id (не длиннее 64 символов) задаёте вы, он возвращается вместе с результатом. webhook_id может уведомить зарегистрированный вебхук Clay об окончании запуска. Запуски тратят кредиты Clay, поэтому ИИ заранее сообщает, какую функцию и на скольких элементах он запускает.
2. clay_get_run_results с routine_run_id: пока идёт выполнение, HTTP 202 и status: in_progress, затем 200 со status: complete и data. Результаты сопоставляются с входными данными по id, а не по порядку; завершённый запуск может содержать неудачные элементы, и finished включает неудачи. ИИ проверяет раз в несколько секунд, а не в плотном цикле.
3. clay_get_batch_run_results отслеживает пакетный запуск из Clay CLI или API; завершённый пакет возвращает result_url файла с результатами.

Таблицы (тарифы Enterprise): clay_query_tables читает строки известных таблиц с выбором полей, фильтрами, сортировкой, группировкой и объединениями; id таблицы есть в её URL (.../tables/t_...). Каждая ячейка приходит со status: success (с value), empty, error (с error) или состоянием ожидания (running, queued, retry, rate_limited, awaiting_callback). Если строка меняется во время чтения, она может прийти дважды, поэтому ИИ убирает дубли по id.

Workflow (бета): clay_get_runs_query_reference даёт грамматику запросов к запускам, затем clay_query_workflow_runs находит запуски (запрос select возвращает их, начиная с новых, запрос count даёт их число). Запрос не длиннее 2000 символов; данные могут отставать на несколько секунд.

Отключено при установке: clay_privacy_delete_people удаляет людей из Clay Audiences по запросу о персональных данных, например об удалении по GDPR, находя их по email, slug LinkedIn (часть после /in/, а не URL) или телефону, от 1 до 100 идентификаторов за вызов. Это необратимо, поэтому администратор рабочего пространства включает инструмент при необходимости; затем сначала запустите его с dry_run: true, чтобы посчитать совпадения, и следите за заданием через clay_get_privacy_deletion_status, который доступен до пяти дней после окончания задания.

Постраничный вывод: коллекции возвращают data и cursor, пока есть следующие страницы; ИИ передаёт курсор обратно. Запросы к таблицам по умолчанию возвращают 50 строк на страницу (максимум 100), результаты запусков 20 (максимум 100), страницы поиска 20 (до 500 на платных тарифах, 50 на бесплатном и пробном).

Частые ошибки: ошибки содержат message. 401 или 403 означает неверный ключ или отсутствие доступа, 402 достигнутый лимит результатов поиска, 404 неизвестный id или функцию без доступа API, 409 или 422 недопустимое состояние запроса или входные данные. 429 это лимит частоты рабочего пространства: подождите столько секунд, сколько указано в Retry-After.

Чего он не делает: в Clay Public API нет эндпоинтов, чтобы перечислить таблицы или функции, создать таблицу или записать строки. Строки по-прежнему попадают в таблицу через её входящий вебхук, а id функций и таблиц копируются из приложения Clay.

Шаг 2 — Установите адаптер

curl -fsSL https://raw.githubusercontent.com/HelpCode-ai/anythingmcp/main/docker-compose.quickstart.yml -o docker-compose.yml
printf 'JWT_SECRET=%s\nENCRYPTION_KEY=%s\n' "$(openssl rand -hex 32)" "$(openssl rand -hex 32)" > .env
docker compose up -d

Шаг 3 — Добавьте коннектор в ChatGPT

URL вашего сервера: в AnythingMCP откройте MCP Servers → сервер, на котором находится этот коннектор, и скопируйте его URL (https://cloud.anythingmcp.com/mcp/…). Используйте его везде, где в этом руководстве указано YOUR_SERVER_ID.

ChatGPT добавляет MCP-серверы как плагины на странице Plugins, в веб-версии и в платных планах. Режим разработчика для этого больше не нужен. В рабочем пространстве Business это могут только администраторы и владельцы; в Enterprise и Edu администратор может выдать право Create plugins with MCPs.

1. Перейди на chatgpt.com/plugins, нажми +, затем Add custom MCP server.
2. Введи название, например Name: Clay.
3. В разделе Connection укажи в поле Server URL адрес https://cloud.anythingmcp.com/mcp/YOUR_SERVER_ID и оставь Authentication на OAuth.
4. Выбери I understand and want to continue, затем Create as a plugin. Когда ChatGPT попросит, войди в AnythingMCP и разреши доступ.
5. Установи новый плагин из своих личных плагинов, затем введи @ в чате и выбери его.

Доступные инструменты

Примеры запросов

• «Сколько кредитов Clay у нас осталось?»
• «Найди VP по продажам в софтверных компаниях Германии с численностью от 50 до 200 сотрудников и покажи первых 20.»
• «Запусти нашу функцию обогащения компаний function:t_abc123 на этих пяти доменах и покажи результаты, когда запуск завершится.»
• «Покажи из таблицы t_0te9i4tZEHwc9hihBXu компании с заполненным доменом, отсортированные по домену.»
• «Какие запуски наших Workflow в Clay завершились ошибкой за последние 24 часа?»

FAQ

Работает ли бесплатный план ChatGPT со своими MCP-серверами? OpenAI описывает свои MCP-серверы только для платных планов; план Free в этом списке не указан.

Следующие шаги

• Страница коннектора
• Подключить к Claude
• Подключить к Cursor
• Подключить к Gemini
• Подключить к Meta Muse
• Подключить к Microsoft Copilot