← Документация ConnectMachine

Model Context Protocol

MCP-сервер ConnectMachine

ConnectMachine предоставляет удалённый MCP-сервер: любой совместимый ИИ-инструмент может управлять вашими контактами, событиями, сетями и цифровыми визитками в обычном диалоге. Устанавливать ничего не нужно: подключение идёт по HTTPS с вашим личным ключом.

Доступно всем аккаунтам ConnectMachine. Отдельные расширенные действия подчиняются тем же правилам Premium, что и в приложении.

01

Что даёт сервер

Сервер публикует 40 инструментов. Ассистент сам выбирает нужный; вызывать их по имени не требуется.

  • Контакты (12): список, поиск, создание, обновление, удаление, умный поиск, отрасли, дубликаты, объединение, сети.
  • События (3): список событий, добавление и удаление события, где вы познакомились.
  • Сети (5): список, создание, обновление, удаление, порядок.
  • Цифровые визитки (7): полное управление, общая визитка, распознавание фото визитки.
  • Импорт и экспорт (6): пакетный импорт, статус, экспорт CSV.
  • Уведомления и профиль (7): уведомления, счётчики, профиль, подписка.
Важно

Инструменты ИИ-запросов и расшифровки встреч появятся позже.

02

Получите ключ MCP

Ключ - это личный токен вашего аккаунта. Откройте страницу подключения MCP, войдите по коду на почту или через Google и скопируйте ключ вместе с готовыми конфигурациями. Держите ключ в секрете; для отзыва создайте новый.

  • Страница подключения: licenses.connectmachine.ai/mcp/auth
  • Каждый запрос инструмента аутентифицируется этим ключом только для вашего аккаунта.
03

Подключение Claude

Claude поддерживает удалённые MCP-серверы в вебе, настольном приложении и Claude Code.

  • Claude веб и десктоп: Настройки > Коннекторы > Добавить пользовательский коннектор, адрес https://mcp.connectmachine.ai/mcp.
  • Claude Code: claude mcp add --transport http connectmachine https://mcp.connectmachine.ai/mcp --header "Authorization: Bearer ВАШ_КЛЮЧ".
  • Клиенты с JSON: добавьте сервер в mcpServers с url и заголовком Authorization: Bearer.
04

Подключение Cursor

Создайте или отредактируйте .cursor/mcp.json в проекте (или глобальный ~/.cursor/mcp.json), добавив запись connectmachine в mcpServers с url сервера и заголовком Authorization с ключом. Перезапустите Cursor.

Важно

Адрес сервера: https://mcp.connectmachine.ai/mcp

05

Подключение VS Code

VS Code использует объект servers вместо mcpServers. Создайте .vscode/mcp.json с записью типа "http", url сервера и заголовком Authorization. Страница подключения генерирует этот файл автоматически.

06

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

Любой клиент с поддержкой удалённых HTTP MCP-серверов подключается по двум значениям: URL сервера и ключ в заголовке Authorization. Клиенты с поддержкой OAuth-потока MCP могут входить через браузер: сервер поддерживает OAuth 2.0 с динамической регистрацией и PKCE.

  • Адрес сервера: https://mcp.connectmachine.ai/mcp
  • Заголовок: Authorization: Bearer ВАШ_КЛЮЧ
07

Как ведут себя инструменты

Сервер устроен так, чтобы ассистент не мог незаметно ошибиться с вашей сетью.

  • Одинаковые имена: при совпадении имён find_contact сообщает о неоднозначности и просит ассистента уточнить у вас, а не угадывать.
  • События, а не теги: фиксируется событие знакомства, как в приложении.
  • Поиск охватывает имя, компанию, должность, почту, телефон, заметки, местоположение и события.
  • Новые аккаунты: до завершения онбординга в приложении инструменты возвращают подсказки и ссылки на скачивание.
08

Тарифы и Premium-действия

Подключение ИИ-инструмента входит в ConnectMachine. Действия уровня Premium остаются такими и в MCP: экспорт CSV, фильтры по отрасли и местоположению. Бесплатный аккаунт получает понятное сообщение с названием функции и способом обновления.

09

Приватность и безопасность

MCP-сервер - это тонкий аутентифицированный мост к API ConnectMachine. Копия вашей сети на нём не хранится.

  • Ключ проверяется на каждом запросе; доступа между аккаунтами нет.
  • Ассистент получает только данные, нужные для конкретного запроса.
  • Отзыв доступа: создайте новый ключ или удалите конфигурацию из инструмента.
  • Условия и приватность: connectmachine.ai/ru/legal/terms-of-service и connectmachine.ai/ru/legal/privacy.
10

Устранение неполадок

Большинство проблем связано с URL, ключом или состоянием аккаунта.

  • Недействительный ключ: войдите на страницу подключения заново и используйте новый ключ.
  • Сообщение об онбординге: завершите настройку в приложении и повторите запрос.
  • Сообщение Premium: действие требует платного плана; остальное продолжает работать.
  • Нет соединения: проверьте, что адрес ровно https://mcp.connectmachine.ai/mcp, и перезапустите инструмент после изменения конфигурации.