Leverages Cloudflare Workers for deployment of the MCP server, using Durable Objects for persistent state management and KV storage for token management
Integrates with GitHub's OAuth services for authentication, enabling secure access to the MCP server through GitHub credentials
Acts as a middleware to the upstream Sentry API provider, allowing AI agents to interact with Sentry's monitoring and error tracking capabilities
Это прототип удаленного сервера MCP, выступающего в качестве промежуточного программного обеспечения для вышестоящего поставщика Sentry API.
Он основан на работе Cloudflare по созданию удаленных MCP .
Вы найдете всю необходимую информацию, посетив развернутую службу в производстве:
Если вы хотите внести свой вклад, узнать, как это работает, или запустить это для самостоятельно размещенного Sentry, продолжайте ниже.
Хотя этот репозиторий ориентирован на работу в качестве сервиса MCP, мы также поддерживаем транспорт stdio . Это все еще находится в процессе разработки, но это самый простой способ адаптировать запуск MCP против размещенной на собственном сервере установки Sentry.
Чтобы использовать транспорт stdoio , вам нужно создать Personal API Token (PAT) в Sentry с необходимыми областями. На момент написания это:
Запустить транспорт:
Примечание: Вы также можете использовать переменные среды:
MCP включает в себя инспектор для легкого тестирования сервиса:
Введите https://[domain].workers.dev/sse (TODO) и нажмите connect. После того, как вы пройдете процесс аутентификации, вы увидите, что инструменты работают:
Откройте Claude Desktop и перейдите в Settings, нажмите ⌘ + , (запятая) -> Developer -> Edit Config. Это откроет файл конфигурации, который управляет тем, к каким серверам MCP Claude может получить доступ.
Замените содержимое следующей конфигурацией. После перезапуска Claude Desktop откроется окно браузера, отображающее вашу страницу входа OAuth. Завершите процесс аутентификации, чтобы предоставить Claude доступ к вашему серверу MCP. После предоставления доступа инструменты станут доступны для использования.
Как только в интерфейсе появятся инструменты (под 🔨), вы можете попросить Клода использовать их. Например: «Не могли бы вы использовать математический инструмент, чтобы сложить 23 и 19?». Клод должен вызвать инструмент и показать результат, сгенерированный сервером MCP.
Если вы хотите итерировать и тестировать свой сервер MCP, вы можете сделать это в локальной разработке. Для этого вам потребуется создать еще одно приложение OAuth в Sentry (Настройки => API => Приложения ):
http://localhost:8788http://localhost:8788/callback.dev.vars в корневом каталоге проекта с помощью:Запустите сервер локально, чтобы сделать его доступным по адресу http://localhost:8788
Чтобы протестировать локальный сервер, введите http://localhost:8788/sse в Inspector и нажмите connect. После того, как вы выполните подсказки, вы сможете "List Tools".
В комплект входят два набора тестов: базовые модульные тесты и несколько оценок.
Модульные тесты можно запустить с помощью:
Для Evals потребуется файл .env с некоторой конфигурацией:
После этого вы можете запустить их с помощью:
При использовании Claude для подключения к удаленному серверу MCP вы можете увидеть некоторые сообщения об ошибках. Это связано с тем, что Claude Desktop пока не поддерживает удаленные серверы MCP, поэтому иногда он путается. Чтобы проверить, подключен ли сервер MCP, наведите курсор на значок 🔨 в правом нижнем углу интерфейса Claude. Вы должны увидеть там свои инструменты.
Чтобы подключить Cursor к вашему серверу MCP, выберите Type : «Команда» и в поле Command объедините поля команда и аргументы в одно (например npx mcp-remote https://<your-worker-name>.<your-subdomain>.workers.dev/sse ).
Обратите внимание, что хотя Cursor поддерживает серверы HTTP+SSE, он не поддерживает аутентификацию, поэтому вам все равно придется использовать mcp-remote (и использовать сервер STDIO, а не HTTP).
Вы можете подключить свой сервер MCP к другим клиентам MCP, таким как Windsurf, открыв файл конфигурации клиента, добавив тот же JSON, который использовался для настройки Клода, и перезапустив клиент MCP.
You must be authenticated.
remote-capable server
The server can be hosted and run remotely because it primarily relies on remote services or has no dependency on the local environment.
Удаленный сервер Model Context Protocol, выступающий в качестве промежуточного программного обеспечения для Sentry API, позволяя помощникам ИИ, таким как Клод, получать доступ к данным и функциональным возможностям Sentry через интерфейсы на естественном языке.