mcp-server · spanlens — MCP-сервер для Claude Code: запросы и установка
MCP-сервер даёт агенту доступ к данным наблюдаемости Spanlens: расходам, трассам, ошибкам и аномалиям. Подходит для анализа LLM-вызовов из IDE.
claude mcp add --env SPANLENS_API_KEY=<SPANLENS_API_KEY> --env SPANLENS_BASE_URL=<SPANLENS_BASE_URL> --transport stdio mcp-server -- npx -y @spanlens/mcp-serverЧто делает mcp-server
mcp-server подключает агент к рабочему пространству Spanlens через MCP. Он предоставляет семь инструментов для статистики расходов и токенов, поиска отдельных запросов, списка трасс и просмотра дерева спанов. Также сервер находит аномалии, предлагает замены моделей и показывает расходы по конечным пользователям.
Для запуска нужен ключ sl_live_pub_* в переменной SPANLENS_API_KEY; сервер проверяет его область доступа при старте. Полный ключ sl_live_* он отклоняет, а публичный ключ остаётся доступным только для чтения. Подключение запускается через npx -y @spanlens/mcp-server, а для собственного развёртывания Spanlens можно задать SPANLENS_BASE_URL.
Запросы можно группировать по модели или провайдеру, фильтровать по статусу, пользователю и времени. Без публичного ключа сервер не запустится, поэтому секрет для IDE нужно создать заранее.
Какие задачи решает
- проверить расходы LLM по моделям и провайдерам
- найти аномалии в стоимости и задержке
- просмотреть ошибки отдельных LLM-запросов
- разобрать дерево спанов агентского запуска
- сравнить модели по потенциальной экономии
Примеры запросов агенту
- Покажи расходы на LLM за эту неделю и сгруппируй их по провайдеру.
- Найди аномалии в стоимости или задержке за последний период.
- Покажи последние ошибочные вызовы модели
gpt-4oи разберись с трассойabc123….
Как установить mcp-server
Командой платформы
claude mcp add --env SPANLENS_API_KEY=<SPANLENS_API_KEY> --env SPANLENS_BASE_URL=<SPANLENS_BASE_URL> --transport stdio mcp-server -- npx -y @spanlens/mcp-serverВместо <…> подставьте свои значения
Командой платформы
codex mcp add mcp-server --env SPANLENS_API_KEY=<SPANLENS_API_KEY> --env SPANLENS_BASE_URL=<SPANLENS_BASE_URL> -- npx -y @spanlens/mcp-serverВместо <…> подставьте свои значения
Файл настроек
{
"mcpServers": {
"mcp-server": {
"command": "npx",
"args": [
"-y",
"@spanlens/mcp-server"
],
"env": {
"SPANLENS_API_KEY": "<SPANLENS_API_KEY>",
"SPANLENS_BASE_URL": "<SPANLENS_BASE_URL>"
}
}
}
}Вместо <…> подставьте свои значения
Файл настроек
{
"servers": {
"mcp-server": {
"type": "stdio",
"command": "npx",
"args": [
"-y",
"@spanlens/mcp-server"
],
"env": {
"SPANLENS_API_KEY": "<SPANLENS_API_KEY>",
"SPANLENS_BASE_URL": "<SPANLENS_BASE_URL>"
}
}
}
}Вместо <…> подставьте свои значения
Командой платформы
gemini mcp add -e SPANLENS_API_KEY=<SPANLENS_API_KEY> -e SPANLENS_BASE_URL=<SPANLENS_BASE_URL> mcp-server npx -y @spanlens/mcp-serverВместо <…> подставьте свои значения
По шагам, с командами для каждой платформы: Как подключить MCP-сервер: Claude Code, Codex, Cursor, VS Code, Gemini CLI и другие
Вопросы о mcp-server
Как установить mcp-server в Claude Code?
Выполните claude mcp add mcp-server -e SPANLENS_API_KEY=<SPANLENS_API_KEY> -- npx -y @spanlens/mcp-server. Ключ должен иметь публичную область доступа.
Что делает mcp-server?
Он позволяет агенту запрашивать данные Spanlens о расходах, токенах, задержке, ошибках, трассах и использовании моделей через MCP.
Какой ключ нужен для работы сервера?
Нужен ключ sl_live_pub_* из раздела Public Keys. Сервер откажется запускаться с полным ключом sl_live_*, а публичный ключ не может вызывать операции прокси или отправки данных.
Похожие MCP-серверы
Все MCP-серверы по теме «ИИ и ML» →Сначала — mcp-server от других авторов.
