portkey-admin-mcp — MCP-сервер для Claude Code: как установить
Управляет шлюзом Portkey через MCP: настраивает промпты, ключи, маршрутизацию и лимиты. Пригодится для контроля AI-инфраструктуры прямо из редактора.
claude mcp add --env PORTKEY_API_KEY=<PORTKEY_API_KEY> --env PORTKEY_TOOL_DOMAINS=<PORTKEY_TOOL_DOMAINS> --env PORTKEY_BASE_URL=<PORTKEY_BASE_URL> --transport stdio portkey-admin-mcp -- npx -y portkey-admin-mcpЧто делает portkey-admin-mcp
Сервер открывает агенту доступ к панели управления Portkey через Admin API. Набор включает 194 инструмента для маршрутизации моделей и версий промптов. Для запуска требуется среда Node.js от 24 версии. Также понадобится действующий ключ PORTKEY_API_KEY.
Полный каталог весит около 400 КБ при обходе страниц. Без переменной PORTKEY_TOOL_DOMAINS контекст агента быстро перегружается схемами вызовов. Ограничение доменов оставляет только рабочие разделы, например prompts или analytics. Это сохраняет токены.
Интеграция рассчитана на API Portkey с заголовком x-portkey-api-key. Простая замена адреса в PORTKEY_BASE_URL не превратит его в клиент Prisma AIRS из-за иной схемы авторизации. Сервер стартует через npx либо в виде скомпилированного скрипта.
Какие задачи решает
- Управлять версиями и фрагментами системных промптов в Portkey
- Настраивать маршрутизацию, повторные попытки и балансировку шлюза
- Задавать защитные барьеры и правила доступа к моделям
- Контролировать лимиты расходов и потребления токенов
- Обновлять виртуальные ключи провайдеров и внешние секреты
Примеры запросов агенту
- Поменяй конфигурацию шлюза в Portkey: настрой балансировку между двумя провайдерами.
- Проверь лимиты расходов и текущее потребление токенов в проекте через Portkey.
- Создай новую версию промпта для классификации и привяжи к ней ярлык
staging.
Как установить portkey-admin-mcp
Командой платформы
claude mcp add --env PORTKEY_API_KEY=<PORTKEY_API_KEY> --env PORTKEY_TOOL_DOMAINS=<PORTKEY_TOOL_DOMAINS> --env PORTKEY_BASE_URL=<PORTKEY_BASE_URL> --transport stdio portkey-admin-mcp -- npx -y portkey-admin-mcpВместо <…> подставьте свои значения
Командой платформы
codex mcp add portkey-admin-mcp --env PORTKEY_API_KEY=<PORTKEY_API_KEY> --env PORTKEY_TOOL_DOMAINS=<PORTKEY_TOOL_DOMAINS> --env PORTKEY_BASE_URL=<PORTKEY_BASE_URL> -- npx -y portkey-admin-mcpВместо <…> подставьте свои значения
Файл настроек
{
"mcpServers": {
"portkey-admin-mcp": {
"command": "npx",
"args": [
"-y",
"portkey-admin-mcp"
],
"env": {
"PORTKEY_API_KEY": "<PORTKEY_API_KEY>",
"PORTKEY_TOOL_DOMAINS": "<PORTKEY_TOOL_DOMAINS>",
"PORTKEY_BASE_URL": "<PORTKEY_BASE_URL>"
}
}
}
}Вместо <…> подставьте свои значения
Файл настроек
{
"servers": {
"portkey-admin-mcp": {
"type": "stdio",
"command": "npx",
"args": [
"-y",
"portkey-admin-mcp"
],
"env": {
"PORTKEY_API_KEY": "<PORTKEY_API_KEY>",
"PORTKEY_TOOL_DOMAINS": "<PORTKEY_TOOL_DOMAINS>",
"PORTKEY_BASE_URL": "<PORTKEY_BASE_URL>"
}
}
}
}Вместо <…> подставьте свои значения
Командой платформы
gemini mcp add -e PORTKEY_API_KEY=<PORTKEY_API_KEY> -e PORTKEY_TOOL_DOMAINS=<PORTKEY_TOOL_DOMAINS> -e PORTKEY_BASE_URL=<PORTKEY_BASE_URL> portkey-admin-mcp npx -y portkey-admin-mcpВместо <…> подставьте свои значения
По шагам, с командами для каждой платформы: Как подключить MCP-сервер: Claude Code, Codex, Cursor, VS Code, Gemini CLI и другие
Вопросы о portkey-admin-mcp
Как установить portkey-admin-mcp в Claude Code?
Выполните команду claude mcp add portkey-admin-mcp -e PORTKEY_API_KEY=<PORTKEY_API_KEY> -- npx -y portkey-admin-mcp, подставив собственный ключ Portkey вместо <PORTKEY_API_KEY>.
Зачем нужен MCP-сервер portkey-admin-mcp?
Он связывает ИИ-агента с панелью Portkey, позволяя менять правила маршрутизации, тестировать промпты и отслеживать бюджеты без переключения в браузер.
Как сократить размер контекста при подключении всех инструментов?
Передайте переменную окружения PORTKEY_TOOL_DOMAINS со списком нужных категорий через запятую, например prompts,analytics. Это отсечёт неиспользуемые разделы каталога.
