Sentry MCP

сентри-mcp

Это прототип удаленного сервера MCP, выступающего в качестве промежуточного программного обеспечения для вышестоящего поставщика Sentry API.

Он основан на работе Cloudflare по созданию удаленных MCP .

Начиная

Вы найдете всю необходимую информацию, посетив развернутую службу в производстве:

https://mcp.sentry.dev

Если вы хотите внести свой вклад, узнать, как это работает, или запустить это для самостоятельно размещенного Sentry, продолжайте ниже.

Stdio против Remote

Хотя этот репозиторий ориентирован на работу в качестве сервиса MCP, мы также поддерживаем транспорт stdio . Это все еще находится в процессе разработки, но это самый простой способ адаптировать запуск MCP против размещенной на собственном сервере установки Sentry.

Чтобы использовать транспорт stdoio , вам нужно создать Personal API Token (PAT) в Sentry с необходимыми областями. На момент написания это:

Запустить транспорт:

Примечание: Вы также можете использовать переменные среды:

Инспектор МКП

MCP включает в себя инспектор для легкого тестирования сервиса:

Введите URL сервера MCP ( http://localhost:5173 ) и нажмите «подключиться». Это должно запустить процесс аутентификации для вас.

Примечание: Если у вас возникли проблемы с потоком OAuth при доступе к инспектору по адресу 127.0.0.1 , попробуйте использовать localhost , перейдя по адресу http://localhost:6274 .

Местное развитие

Если вы хотите итерировать и тестировать свой сервер MCP, вы можете сделать это в локальной разработке. Для этого вам потребуется создать еще одно приложение OAuth в Sentry (Настройки => API => Приложения ):

• В качестве URL-адреса домашней страницы укажите http://localhost:8788
• Для разрешенных URI перенаправления укажите http://localhost:8788/callback
• Запишите свой идентификатор клиента и сгенерируйте секретный код клиента.
• Создайте файл .dev.vars в корневом каталоге проекта с помощью:

Проверять

Запустите сервер локально, чтобы сделать его доступным по адресу http://localhost:8788

Чтобы протестировать локальный сервер, введите http://localhost:8788/sse в Inspector и нажмите connect. После того, как вы выполните подсказки, вы сможете "List Tools".

Тесты

В комплект входят два набора тестов: базовые модульные тесты и несколько оценок.

Модульные тесты можно запустить с помощью:

Для Evals потребуется файл .env с некоторой конфигурацией:

После этого вы можете запустить их с помощью:

Примечания

Использование Claude и других клиентов MCP

При использовании Claude для подключения к удаленному серверу MCP вы можете увидеть некоторые сообщения об ошибках. Это связано с тем, что Claude Desktop пока не поддерживает удаленные серверы MCP, поэтому иногда он путается. Чтобы проверить, подключен ли сервер MCP, наведите курсор на значок 🔨 в правом нижнем углу интерфейса Claude. Вы должны увидеть там свои инструменты.

Использование Cursor и других MCP-клиентов

Чтобы подключить Cursor к вашему серверу MCP, выберите Type : «Команда» и в поле Command объедините поля команда и аргументы в одно (например npx mcp-remote@latest https://<your-worker-name>.<your-subdomain>.workers.dev/sse ).

Обратите внимание, что хотя Cursor поддерживает серверы HTTP+SSE, он не поддерживает аутентификацию, поэтому вам все равно придется использовать mcp-remote (и использовать сервер STDIO, а не HTTP).

Вы можете подключить свой сервер MCP к другим клиентам MCP, таким как Windsurf, открыв файл конфигурации клиента, добавив тот же JSON, который использовался для настройки Клода, и перезапустив клиент MCP.