Установка Didit MCP: Claude, Cursor, VS Code, Windsurf

Выберите клиент ниже. Размещённый сервер (https://mcp.didit.me/mcp) не требует API-ключа: при первом подключении клиент откроет браузер, где вы нажмёте Вход через Didit и одобрите разрешения.

Используете Claude? На странице Подключение Claude есть ссылка для подключения в один клик. Она открывает диалог Add custom connector с уже заполненными именем и URL, поэтому вам остаётся только подтвердить и войти.

Клиенты, которые пока не поддерживают удалённый MCP по HTTP (Windsurf, Zed), подключаются через мост mcp-remote. Он перенаправляет stdio на размещённый URL и сам выполняет OAuth-рукопожатие.

Размещённый сервер (рекомендуется)

Добавьте сервер через CLI, затем запустите вход:

claude mcp add --transport http didit https://mcp.didit.me/mcp

Запустите Claude Code и выполните /mcp. Откроется браузер с кнопкой Вход через Didit. После одобрения станут доступны инструменты didit.

Веб: нажмите Add Didit to Claude → и подтвердите диалог с заполненными полями.Desktop: Settings → Connectors → Add custom connector, назовите сервер Didit и укажите URL:

https://mcp.didit.me/mcp

Нажмите Connect и выполните Вход через Didit в браузере. Инструменты Didit появятся в меню инструментов чата.

Добавьте в ~/.cursor/mcp.json (глобально) или в .cursor/mcp.json (для проекта):

{
  "mcpServers": {
    "didit": {
      "url": "https://mcp.didit.me/mcp"
    }
  }
}

Или откройте Settings → Tools & Integrations → New MCP Server. Cursor регистрируется в Didit через Dynamic Client Registration и при первом использовании открывает браузер для входа.

В агентном режиме GitHub Copilot добавьте .vscode/mcp.json:

{
  "servers": {
    "didit": {
      "type": "http",
      "url": "https://mcp.didit.me/mcp"
    }
  }
}

Или выполните MCP: Add Server в командной палитре и выберите HTTP. Войдите, когда будет предложено. Укажите в VS Code полный URL с /mcp: сервер публикует метаданные OAuth-ресурса именно для этого пути.

Windsurf подключается через мост mcp-remote. Добавьте в ~/.codeium/windsurf/mcp_config.json:

{
  "mcpServers": {
    "didit": {
      "command": "npx",
      "args": ["-y", "mcp-remote@latest", "https://mcp.didit.me/mcp"]
    }
  }
}

Откройте Settings → Cascade → MCP Servers → Manage, чтобы убедиться, что сервер загружен, затем войдите через браузер.

Добавьте контекстный сервер в settings.json Zed:

{
  "context_servers": {
    "didit": {
      "source": "custom",
      "command": "npx",
      "args": ["-y", "mcp-remote@latest", "https://mcp.didit.me/mcp"]
    }
  }
}

Zed запускает мост и открывает браузер с кнопкой Вход через Didit.

Любой клиент, который реализует MCP через Streamable HTTP с OAuth 2.1, может подключиться к https://mcp.didit.me/mcp напрямую. Он находит сервер авторизации по адресу https://mcp.didit.me/.well-known/oauth-protected-resource/mcp, регистрируется через Dynamic Client Registration и проходит поток PKCE. Сервер принимает только POST на /mcp. GET и DELETE возвращают 405, потому что сервер работает без состояния и не ведёт поток, инициируемый сервером.Клиент, который работает только через stdio, может использовать тот же мост mcp-remote, что и Windsurf с Zed:

npx -y mcp-remote@latest https://mcp.didit.me/mcp

Чтобы попробовать сервер без клиента, MCP Inspector подключается к тому же URL и поможет выполнить вход.

В конфигурации нет API-ключа. Размещённый сервер аутентифицирует вас в браузере и действует как вы: от имени каждой организации, в которой вы состоите, с разрешениями вашей роли. См. Аутентификация.

Размещённый сервер по запросу GET https://mcp.didit.me/healthz возвращает свою версию.

Проверка подключения

После входа спросите у клиента:

Use the Didit MCP server to call didit_context_get and list my organizations and applications.

Агент должен вызвать didit_context_get и показать ваши организации с их приложениями. Если он сообщает, что у него нет инструментов Didit, значит, сервер не подключился или вход не был завершён. См. Устранение неполадок.

Самостоятельное развертывание

Хостируемый сервер собран из открытого репозитория github.com/didit-protocol/mcp (MIT). Каждый релиз также публикуется в npm как @didit-protocol/mcp-server, поэтому stdio-сервер можно запустить прямо из npm или собрать любую из точек входа, клонировав репозиторий. Одна кодовая база включает две точки входа:

Точка входа	Режим	Транспорт	Аутентификация
`dist/http.js`	Хостируемый	Streamable HTTP на `MCP_PORT` (по умолчанию 3000), `POST /mcp`, `GET /healthz`	OAuth 2.1 Bearer, проверяется интроспекцией токена
`dist/index.js`	stdio (без интерфейса)	MCP stdio	Токен доступа пользователя в `DIDIT_ACCESS_TOKEN`

Оба режима работают от имени пользователя Didit. Режима с API-ключом приложения не существует.

Клонируйте и соберите

git clone https://github.com/didit-protocol/mcp.git && cd mcp
npm install && npm run build

Или соберите контейнер: docker build -t didit-mcp .. Образ запускает dist/http.js от имени непривилегированного пользователя, открывает порт 3000 и имеет проверку состояния на /healthz.

Запустите HTTP-сервер (OAuth)

Скопируйте .env.example в .env и заполните значения для хостируемого режима, затем выполните:

node dist/http.js
# or
docker run -p 3000:3000 --env-file .env didit-mcp

Сервер является только сервером ресурсов OAuth. Ему нужна переменная MCP_RESOURCE_URI с полным публичным URL транспорта (например, https://mcp.example.com/mcp, а не только базовый URL), а также учетные данные (MCP_OAUTH_CLIENT_ID, MCP_OAUTH_CLIENT_SECRET), с помощью которых выполняется интроспекция токенов на сервере авторизации Didit. Полный список переменных приведен в разделе Расширенные настройки → самостоятельное развертывание.

Или запустите через stdio (без интерфейса)

Для локального агента, который не может пройти процесс OAuth, запустите опубликованный пакет (клонировать репозиторий не нужно) и передайте токен доступа пользователя через переменную окружения:

DIDIT_ACCESS_TOKEN=<user-access-token> npx -y @didit-protocol/mcp-server

Из клона та же команда выглядит так: DIDIT_ACCESS_TOKEN=<user-access-token> node dist/index.js. Без токена агент может войти с помощью didit_account_login, а затем вызвать didit_account_verify_2fa, если в аккаунте включена двухфакторная аутентификация.Необязательные переменные MCP_DEFAULT_ORG и MCP_DEFAULT_APP закрепляют область действия для конфигураций с одним арендатором. Чтобы зарегистрировать сервер в Claude Code, выполните:

claude mcp add didit-local -e DIDIT_ACCESS_TOKEN=<user-access-token> -- npx -y @didit-protocol/mcp-server

Или добавьте его в mcp.json в Cursor:

{
  "mcpServers": {
    "didit-local": {
      "command": "npx",
      "args": ["-y", "@didit-protocol/mcp-server"],
      "env": { "DIDIT_ACCESS_TOKEN": "<user-access-token>" }
    }
  }
}

Открытый stdio-сервер не включает инструменты хостируемого сервера для Travel Rule, маркетплейса, сети противодействия мошенничеству и токенов транзакционного SDK, а также его инструменты комплаенса, кроме инструмента создания сценария. Он добавляет didit_org_top_up, didit_org_reveal_application_api_key и пять инструментов настройки аккаунта (didit_account_register, didit_account_verify_email, didit_account_resend_otp, didit_account_login, didit_account_verify_2fa). Они принимают учетные данные как аргументы, поэтому никогда не включаются в удалённый коннектор. Инструменты, которые работают с файлами, на stdio также принимают аргументы *_path, поскольку сервер использует вашу файловую систему.

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

Аутентификация

Вход, области доступа и роли.

Справочник инструментов

Все инструменты, которые может вызвать агент.

Руководства

Аутентификация

Model Context Protocol (MCP)

Веб-SDK

Нативные SDK

Серверные SDK

Интеграции

Установка Didit MCP: Claude, Cursor, VS Code, Windsurf

Размещённый сервер (рекомендуется)

Проверка подключения

Самостоятельное развертывание

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

Аутентификация

Справочник инструментов

​Размещённый сервер (рекомендуется)

​Проверка подключения

​Самостоятельное развертывание

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

Аутентификация

Справочник инструментов

Размещённый сервер (рекомендуется)

Проверка подключения

Самостоятельное развертывание

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