Коннектор MCP для Exact Match Site ID

Этот сервис предоставляет данные Exact Match Site ID для AI-клиентов, совместимых с MCP, таких как ChatGPT, Claude, Cursor и другие инструменты, способные вызывать MCP-серверы.

Стек

• TypeScript

• Hono для HTTP-маршрутов

• Официальный MCP SDK для обработки протокола MCP

• Zod для валидации входных данных

• Laravel data в качестве источника истины

Локальная настройка

1. Скопируйте .env.example в .env.

2. Установите LARAVEL_API_BASE_URL в качестве базового URL API Laravel.

3. Установите LARAVEL_MCP_PROXY_TOKEN в значение, настроенное в Laravel для services.mcp_proxy.internal_token.

4. Установите OAUTH_TOKEN_SECRET как минимум 32 случайными символами.

5. Установите зависимости с помощью npm install.

6. Запустите локальную разработку с помощью npm run dev.

URL локального сервиса по умолчанию: http://localhost:8787.

Полезные URL

• Проверка работоспособности: GET /health

• MCP-эндпоинт: POST /mcp

• Метаданные авторизации OAuth: GET /.well-known/oauth-authorization-server

• Метаданные MCP: GET /.well-known/mcp-server

• Виджет: GET /widgets/site-id

Аутентификация для разработки

Когда MCP_DEV_AUTH_ENABLED=true, локальный код авторизации можно создать, вызвав:

GET /oauth/dev/start?clerk_user_id=user_xxx

В продакшене этот механизм разработки должен быть заменен на реальный callback входа через Exact Match/Clerk.

Локальный поток тестирования OAuth

Используйте этот поток для тестирования OAuth локально перед подключением сервера к приложениям ChatGPT.

1. Убедитесь, что .env содержит локальный список разрешенных редиректов:

OAUTH_ALLOWED_REDIRECT_URIS=http://localhost:8787/oauth/dev/callback
MCP_DEV_AUTH_ENABLED=true

2. Запустите MCP-сервер:

npm run dev

3. Откройте URL авторизации для разработки с реальным идентификатором пользователя Clerk:

http://localhost:8787/oauth/dev/start?clerk_user_id=user_xxx

Браузер перенаправит на:

http://localhost:8787/oauth/dev/callback?code=...&state=...

4. Скопируйте значение code из ответа callback.

5. Обменяйте код на токен доступа MCP:

$code = "paste-code-here"

Invoke-RestMethod `
  -Method Post `
  -Uri "http://localhost:8787/oauth/token" `
  -ContentType "application/x-www-form-urlencoded" `
  -Body @{
    grant_type = "authorization_code"
    client_id = "local-dev"
    redirect_uri = "http://localhost:8787/oauth/dev/callback"
    code = $code
  }

Успешный ответ:

{
  "access_token": "...",
  "token_type": "Bearer",
  "expires_in": 3600,
  "refresh_token": "...",
  "scope": "site_id:read"
}

Используйте access_token как:

Authorization: Bearer <access_token>

Этот токен аутентифицирует запросы AI-приложений к MCP-серверу. MCP-сервер по-прежнему аутентифицируется в Laravel отдельно с помощью LARAVEL_MCP_PROXY_TOKEN.