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

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

WorkOS + Cursor

WorkOS API для B2B-идентификации в одном окружении: организации и их домены, пользователи AuthKit, членства, приглашения и сессии, SSO-подключения, каталоги, пользователи и группы Directory Sync, экспорт Audit Logs, поток событий, роли и права RBAC. Создаёт и обновляет организации, пользователей, членства и приглашения; удаление и отзыв при установке отключены.

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

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

WORKOS_API_KEY

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

Настройка занимает около 2 минут.

1. Откройте https://dashboard.workos.com, выберите окружение (Sandbox или Production) в верхней панели и откройте API Keys.
2. Создайте секретный ключ (sk_..., показывается один раз) и вставьте его в WORKOS_API_KEY без пробелов и без префикса Bearer.
3. Установите коннектор и запустите workos_list_organizations: он покажет организации окружения и подтвердит ключ.

Ключ принадлежит одному окружению и даёт полный доступ к его API: у ключей WorkOS нет scopes. Начните с ключа Sandbox и используйте ключ Production, только когда ИИ должен работать с реальными данными.

Персональные и чувствительные данные: ключ открывает данные идентификации всех организаций окружения, а ИИ читает всё, что возвращает инструмент: имена и адреса email, идентичности входа, IP-адреса и user agent сессий, пользователей каталогов с должностями, метаданные и id клиентов Stripe у организаций, содержимое журналов аудита. workos_get_directory_user и workos_get_directory_group возвращают сырые атрибуты провайдера полностью, а в них могут быть телефоны, руководитель, отдел и табельные номера; инструменты списков их опускают. ИИ передаёт только то, что нужно для задачи.

Секретные значения: коннектор никогда не возвращает API-ключ. Из ответов о приглашениях удалены token и accept_invitation_url, потому что по этой ссылке в организацию может войти любой, у кого она есть. workos_get_audit_log_export возвращает короткоживущую ссылку на скачивание CSV (url); ИИ обращается с ней как с паролем и никуда больше её не вставляет.

Организации и домены: workos_list_organizations (фильтр по тексту имени или домену), workos_get_organization, workos_get_organization_by_external_id, workos_create_organization и workos_update_organization. workos_create_organization_domain добавляет домен в статусе ожидания с DNS-записью TXT (verification_prefix, verification_token), которую публикует владелец домена; затем workos_verify_organization_domain запускает проверку, а workos_get_organization_domain показывает её состояние.

Пользователи, членства и роли: workos_list_users (по email или organization_id), workos_get_user, workos_get_user_by_external_id, workos_create_user (без пароля; человек входит через Magic Auth, вход через соцсети, SSO или приглашение) и workos_update_user; провайдеры входа через workos_list_user_identities, сессии через workos_list_user_sessions. Членства: workos_list_organization_memberships, workos_get_organization_membership, workos_create_organization_membership, workos_update_organization_membership для смены роли, а также workos_deactivate_organization_membership и workos_reactivate_organization_membership, чтобы заблокировать и вернуть доступ. Slug ролей берутся из workos_list_roles, workos_get_role и workos_list_organization_roles (свои роли начинаются с org-), права из workos_list_permissions.

Приглашения: workos_list_invitations, workos_get_invitation, workos_send_invitation (письмо отправляет сам WorkOS) и workos_resend_invitation.

SSO и Directory Sync: workos_list_connections и workos_get_connection показывают тип подключения и state (active означает, что пользователи могут входить). workos_list_directories, workos_get_directory, workos_list_directory_users (нужен directory или group), workos_get_directory_user, workos_list_directory_groups (нужен directory или user) и workos_get_directory_group читают синхронизированных пользователей и группы; workos_sync_directory сразу ставит синхронизацию в очередь.

Audit Logs и события: workos_list_audit_log_actions и workos_list_audit_log_schemas показывают, что записывается. workos_create_audit_log_export запускает экспорт в CSV за период (событий он не пишет), а workos_get_audit_log_export сообщает о его ходе, пока state не станет ready; workos_get_audit_log_retention говорит, сколько дней хранятся события. workos_list_events читает поток событий по типам (user.created, organization_membership.updated, dsync.user.created, connection.activated и другие) с range_start и range_end; order: asc проигрывает их по порядку. API хранит события за 90 дней, один вызов охватывает не больше 30 дней.

Обновления: workos_update_organization и workos_update_user меняют только переданные поля, но domain_data и metadata заменяют сохранённое значение, поэтому ИИ отправляет полный список или объект. Смена email пользователя сбрасывает email_verified в false. Новая роль членства заменяет текущую.

Отключены при установке: workos_delete_organization, workos_delete_organization_domain, workos_delete_user, workos_delete_organization_membership, workos_revoke_invitation, workos_revoke_session и workos_create_audit_log_event. Их нельзя отменить (события журнала аудита нельзя удалить после записи), поэтому администратор рабочего пространства включает их, когда это нужно команде.

Форматы данных: id имеют префикс типа (org_, org_domain_, user_, om_, invitation_, session_, conn_, directory_, directory_user_, directory_group_, audit_log_export_, event_). Отметки времени в ISO 8601, UTC. Списки приходят в виде {"object": "list", "data": [...], "list_metadata": {...}}. Значения metadata это строки.

Постраничный вывод: списки по умолчанию возвращают 10 элементов, с limit до 100, начиная с новых. Для следующей страницы ИИ передаёт list_metadata.after как after и останавливается, когда оно равно null; workos_list_events листается так же.

Ограничения: 6 000 запросов в минуту на ключ; AuthKit 1 000 чтений и 500 записей за 10 секунд; пользователи каталогов 4 запроса в секунду на каталог; удаление организаций 50 в минуту. Письма-приглашения учитываются в лимитах отправки email у WorkOS.

Частые ошибки: 401 означает неверный или отозванный ключ. 403 означает, что ключу это не разрешено или функция не включена для окружения. 404 означает неизвестный id или id из другого окружения. 400 или 422 означает неверное поле, которое названо в теле ответа. 429 означает ограничение частоты: подождите и повторите один раз.

Коннектор не настраивает SSO-подключения, брендинг AuthKit, redirect URI, Vault, Pipes и API-ключи, не задаёт пароли и никогда ни за кого не входит.

Шаг 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. Начинай общаться: агент теперь может вызывать инструменты WorkOS.

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

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

• «У каких организаций SSO-подключение ещё не активно?»
• «Перечисли участников организации Acme Corp с ролями и статусом.»
• «Пригласи [email protected] в организацию Acme Corp с ролью admin.»
• «Какие каталоги находятся в состоянии invalid_credentials и к каким организациям они относятся?»
• «Экспортируй журнал аудита Acme Corp за октябрь в файл CSV.»

FAQ

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

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

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