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

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

Clay + Microsoft Copilot

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 — Добавьте коннектор в Microsoft Copilot

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

Microsoft Copilot использует MCP-серверы через агентов, созданных в Copilot Studio: ты добавляешь AnythingMCP в агента как инструмент, а затем публикуешь агента в Microsoft 365 Copilot и Teams. Copilot Studio подключается из облака Microsoft по Streamable HTTP, который AnythingMCP поддерживает.

1. В Copilot Studio открой своего агента (или создай нового), перейди в Tools и выбери Add a tool → New tool → Model Context Protocol.
2. Укажи Server name (например, AnythingMCP), Server description, которое объясняет, что делает коннектор, и Server URL https://cloud.anythingmcp.com/mcp/YOUR_SERVER_ID. По описанию Copilot Studio решает, когда вызывать сервер.
3. В аутентификации выбери API key, установи Type в Header, укажи имя заголовка X-API-Key и нажми Create.
4. В окне Add tool выбери Create a new connection, вставь MCP API-ключ из AnythingMCP (MCP Servers → твой сервер → API keys) и нажми Add to agent.
5. Проверь в панели Test агента: попроси о том, для чего нужны инструменты Clay.
6. Нажми Publish, затем Channels → Microsoft 365 and Microsoft Teams, оставь включённым Make agent available in Microsoft Copilot и нажми Add channel. See agent in Teams установит агента для тебя; в Microsoft 365 Copilot введи @ и выбери агента.

Хочешь, чтобы каждый входил под своей учётной записью? Вместо API-ключа выбери OAuth 2.0 → Dynamic discovery: каждый пользователь войдёт в AnythingMCP при первом вызове агентом.

Размещаешь сам? Используй публичный HTTPS-адрес своего экземпляра вместо https://cloud.anythingmcp.com. Copilot Studio подключается из облака Microsoft, поэтому localhost не подойдёт.

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

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

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

FAQ

Для какого Copilot это руководство? Для Microsoft 365 Copilot на работе — через агентов Copilot Studio. В приложении Microsoft Copilot для личных аккаунтов добавить свой MCP-сервер нельзя.

Что нужно? Рабочий аккаунт с доступом к Copilot Studio (лицензия или пробная версия), чтобы создать агента. Тем, кто будет пользоваться им в Microsoft 365 Copilot или Teams, нужен доступ к агенту: поделись им или попроси администратора опубликовать его для организации. Если в организации действуют политики данных для коннекторов Power Platform, они распространяются и на MCP-серверы.

Агент не вызывает инструменты. Проверь, что имя заголовка — ровно X-API-Key, а ключ относится к тому же MCP-серверу, что и URL, и сделай Server description конкретным: по нему Copilot Studio решает, когда вызывать сервер. После каждого изменения опубликуй агента заново; в открытом чате введи «start over», чтобы перейти на новую версию.

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

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