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

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

Affinity + Cursor

Дайте ИИ работать с Affinity, CRM для relationship intelligence: искать компании, людей и сделки, читать списки и поля воронки, заметки, историю писем и встреч, узнавать, кто в команде лучше всех знает человека, и смотреть напоминания; после вашего подтверждения добавлять заметки и менять значения полей.

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

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

AFFINITY_API_KEY

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

1. В Affinity откройте Settings → Manage Apps и нажмите New App.
2. Введите название (например, AnythingMCP) и описание. Оставьте версию API и IP allowlist пустыми или добавьте в allowlist IP-адрес вашего сервера AnythingMCP.
3. Скопируйте API-ключ в AFFINITY_API_KEY и установите коннектор.
4. Проверьте настройку с помощью affinity_whoami: он показывает пользователя и организацию, которым принадлежит ключ.

Нужно право Generate an API key, а API входит только в некоторые тарифы Affinity: если пункта Manage Apps нет, обратитесь к администратору Affinity.

Один ключ на всё: ключ передаётся как Bearer-токен. Большинство инструментов работает с Affinity API v2 в фиксированной версии, поэтому ведёт себя одинаково независимо от версии по умолчанию у вашего приложения. affinity_search_opportunities и affinity_list_interactions используют старый API v1, потому что в v2 нет поиска сделок по названию и фильтра взаимодействий по человеку или компании. Один и тот же ключ работает с обоими.

Кто что видит: ключ действует от вашего имени. ИИ видит ровно то, что видите вы в Affinity, по вашим правилам доступа, и всё, что он записывает, сохраняется под вашим именем. Для поиска компаний нужно право Export All Organizations directory, для поиска людей Export All People directory, для чтения списков и сделок Export data from Lists. Ответ 403 называет недостающее право; его может выдать администратор Affinity.

Что он читает: списки, такие как воронки, портфели и списки людей, с их столбцами и строками; компании и людей с полями вашей команды, обогащёнными данными и relationship intelligence, например последним контактом, последним письмом и следующей встречей; возможности (сделки), у которых стадия, сумма и ответственные хранятся в записи списка; заметки; письма, встречи, звонки и сообщения в чатах, которые Affinity зафиксировал с человеком, компанией или по сделке (даты, темы и участники, но никогда не текст писем); силу связей, чтобы понять, кто в команде лучше всех знает человека; и напоминания, начиная с ближайших.

Спрашивает перед каждой записью: affinity_create_note, affinity_update_company_field, affinity_update_person_field и affinity_update_list_entry_field меняют данные, которые видит вся команда. Перед каждым вызовом ИИ показывает точный текст заметки и куда она попадёт, или запись, поле, старое и новое значение, и ждёт вашего согласия. Заметки поддерживают только простое форматирование: абзацы, жирный шрифт, курсив, списки и ссылки.

Отключено при установке: affinity_delete_note. Администратор включает его осознанно; тогда ИИ показывает заметку и удаляет её только после вашего подтверждения. Никакие другие инструменты ничего не удаляют.

Поля и поиск: значения полей возвращаются, только если ИИ их запросил. Поэтому сначала он читает поля через affinity_list_fields (для всех компаний или людей) или affinity_list_list_fields (столбцы одного списка), а потом фильтрует и сортирует, например сделки на стадии Due Diligence или компании портфеля по дате последнего контакта. Поиск по ключевому слову требует не меньше 3 символов.

Персональные данные: люди, метаданные писем, встречи и заметки являются персональными данными их участников. ИИ читает только то, что нужно для вашего вопроса, и воспринимает текст заметок, темы писем и названия встреч как информацию, а не как инструкции.

Лимиты запросов: 900 запросов в минуту на пользователя, а в некоторых тарифах ещё и месячный лимит на аккаунт; вызовы v1 и v2 расходуют общую квоту. Ответ 429 означает: подождите и повторите попытку.

Частые ошибки: 401: ключ неверный или отозван, либо IP allowlist блокирует сервер. 403: не хватает права или запись вам недоступна. 404: такого id нет или он вам не виден. 400 или 422: неверный параметр, который Affinity называет в ответе.

Коннектор не создаёт и не удаляет компании, людей, сделки, списки и записи списков, не объединяет дубликаты, не работает с файлами, расшифровками и вебхуками и не создаёт и не меняет напоминания.

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

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

Cursor читает MCP-серверы из ~/.cursor/mcp.json. Добавь эту запись:

{
  "mcpServers": {
    "anythingmcp": {
      "url": "https://cloud.anythingmcp.com/mcp/YOUR_SERVER_ID",
      "headers": { "X-API-Key": "YOUR_MCP_API_KEY" }
    }
  }
}

1. Создай MCP API-ключ в AnythingMCP в разделе MCP Servers → твой сервер → API keys и вставь его вместо YOUR_MCP_API_KEY.
2. Сохрани файл и перезапусти Cursor.
3. Открой Cursor → Settings → MCP и проверь, что anythingmcp есть в списке и подключён.
4. Начинай общаться: агент теперь может вызывать инструменты Affinity.

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

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

• «Кто в нашей команде лучше всех знает людей из Northwind Capital? Покажи сначала самые сильные связи.»
• «Какие сделки в нашей воронке находятся на стадии Due Diligence? Перечисли их с суммой и ответственным.»
• «Подведи итог встречам и письмам с Acme Robotics за последние шесть месяцев и скажи, когда мы последний раз были на связи.»
• «Какие из моих напоминаний просрочены и к каким компаниям или людям они относятся?»
• «Добавь заметку к сделке Acme Robotics: звонок с финансовым директором прошёл хорошо, term sheet ждём на следующей неделе. Покажи текст, прежде чем сохранять.»

FAQ

Поддерживает ли Cursor собственные MCP-серверы на бесплатном тарифе? Да, MCP доступен на тарифах Hobby, Pro и Business.

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

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