# MCP-сервер ConnectMachine

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

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

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

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

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

**Важно**

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

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

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

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

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

Claude поддерживает удалённые MCP-серверы в вебе, настольном приложении и Claude Code. В Claude веб и десктоп: Настройки, затем Коннекторы, выберите Добавить пользовательский коннектор и вставьте адрес сервера. Для Claude Code создайте `.mcp.json` в корне проекта со сниппетом ниже (замените `YOUR_MCP_KEY` на свой ключ) и перезапустите Claude Code.

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

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

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

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

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

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

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

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

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

```json
{
  "context_servers": {
    "connectmachine": {
      "url": "https://mcp.connectmachine.ai/mcp"
    }
  }
}
```

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

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

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

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

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

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

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

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

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

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

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

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

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

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