← Документация 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 веб и десктоп: Настройки, затем Коннекторы, выберите Добавить пользовательский коннектор и вставьте адрес сервера. Для Claude Code создайте .mcp.json в корне проекта со сниппетом ниже (замените YOUR_MCP_KEY на свой ключ) и перезапустите Claude Code.

.mcp.json
{
  "mcpServers": {
    "connectmachine": {
      "type": "http",
      "url": "https://mcp.connectmachine.ai/mcp",
      "headers": {
        "Authorization": "Bearer YOUR_MCP_KEY"
      }
    }
  }
}
04

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

Создайте или отредактируйте ~/.cursor/mcp.json (глобально) или .cursor/mcp.json в проекте, вставьте сниппет ниже и замените YOUR_MCP_KEY на свой ключ. Перезапустите Cursor, и инструменты ConnectMachine появятся в списке MCP.

~/.cursor/mcp.json
{
  "mcpServers": {
    "connectmachine": {
      "url": "https://mcp.connectmachine.ai/mcp",
      "headers": {
        "Authorization": "Bearer YOUR_MCP_KEY"
      }
    }
  }
}
05

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

VS Code использует объект servers вместо mcpServers. Создайте .vscode/mcp.json в рабочей области, вставьте сниппет ниже и замените YOUR_MCP_KEY на свой ключ.

.vscode/mcp.json
{
  "servers": {
    "connectmachine": {
      "type": "http",
      "url": "https://mcp.connectmachine.ai/mcp",
      "headers": {
        "Authorization": "Bearer YOUR_MCP_KEY"
      }
    }
  }
}
06

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

Zed называет MCP-серверы context servers и поддерживает удалённые нативно, поэтому расширение не нужно. Откройте Settings, затем AI и MCP Servers, нажмите Add Server и выберите Add Remote Server, либо вставьте сниппет ниже в settings.json Zed. Без заголовка Authorization Zed выполняет стандартный OAuth-поток MCP и попросит войти при первом использовании; добавьте объект "headers" с ключом, если предпочитаете статичный токен.

Zed settings.json
{
  "context_servers": {
    "connectmachine": {
      "url": "https://mcp.connectmachine.ai/mcp"
    }
  }
}
07

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

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

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

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

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

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

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

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

10

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

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

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

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

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

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