mcp-api — MCP-сервер для Claude Code: что делает и как установить
Интегрирует локальный сервер FusionAuth с ИИ-ассистентом через API. Позволяет управлять пользователями и приложениями прямо из чата.
claude mcp add --env API_KEY_APIKEYAUTH=<API_KEY_APIKEYAUTH> --env API_BASE_URL=<API_BASE_URL> --env USE_TOOLS=<USE_TOOLS> --transport stdio mcp-api -- npx -y @fusionauth/mcp-apiЧто делает mcp-api
Этот сервер связывает клиентские модели с REST API платформы аутентификации FusionAuth. Инструмент сгенерирован автоматически по спецификации OpenAPI и охватывает свыше 300 конечных точек системы. С ним агент может проверять конфигурацию или регистрировать тестовых пользователей.
Подключать сервер к рабочим базам опасно. Разработчики выпустили его в статусе превью и прямо предупреждают: работа требует передачи сервисного ключа в клиент, поэтому запускать шлюз безопасно только на тестовых стендах.
Без фильтрации вызовов весь набор инструментов занимает почти 200 тысяч токенов контекста. Чтобы агент не зависал от перегрузки контекстного окна, переменную USE_TOOLS стоит ограничить префиксами вроде retrieve,search для операций чтения.
Какие задачи решает
- просматривать список приложений в локальном FusionAuth
- создавать тестовых пользователей по текстовому запросу к модели
- находить учётные записи без ручного входа в административную панель
- ограничивать набор доступных API-методов через фильтр
USE_TOOLS
Примеры запросов агенту
- Посчитай, сколько пользователей зарегистрировано в моей системе FusionAuth
- Выведи список всех настроенных приложений через mcp-api
- Добавь тестового пользователя с почтой [email protected]
Как установить mcp-api
Командой платформы
claude mcp add --env API_KEY_APIKEYAUTH=<API_KEY_APIKEYAUTH> --env API_BASE_URL=<API_BASE_URL> --env USE_TOOLS=<USE_TOOLS> --transport stdio mcp-api -- npx -y @fusionauth/mcp-apiВместо <…> подставьте свои значения
Командой платформы
codex mcp add mcp-api --env API_KEY_APIKEYAUTH=<API_KEY_APIKEYAUTH> --env API_BASE_URL=<API_BASE_URL> --env USE_TOOLS=<USE_TOOLS> -- npx -y @fusionauth/mcp-apiВместо <…> подставьте свои значения
Файл настроек
{
"mcpServers": {
"mcp-api": {
"command": "npx",
"args": [
"-y",
"@fusionauth/mcp-api"
],
"env": {
"API_KEY_APIKEYAUTH": "<API_KEY_APIKEYAUTH>",
"API_BASE_URL": "<API_BASE_URL>",
"USE_TOOLS": "<USE_TOOLS>"
}
}
}
}Вместо <…> подставьте свои значения
Файл настроек
{
"servers": {
"mcp-api": {
"type": "stdio",
"command": "npx",
"args": [
"-y",
"@fusionauth/mcp-api"
],
"env": {
"API_KEY_APIKEYAUTH": "<API_KEY_APIKEYAUTH>",
"API_BASE_URL": "<API_BASE_URL>",
"USE_TOOLS": "<USE_TOOLS>"
}
}
}
}Вместо <…> подставьте свои значения
Командой платформы
gemini mcp add -e API_KEY_APIKEYAUTH=<API_KEY_APIKEYAUTH> -e API_BASE_URL=<API_BASE_URL> -e USE_TOOLS=<USE_TOOLS> mcp-api npx -y @fusionauth/mcp-apiВместо <…> подставьте свои значения
По шагам, с командами для каждой платформы: Как подключить MCP-сервер: Claude Code, Codex, Cursor, VS Code, Gemini CLI и другие
Вопросы о mcp-api
Как установить mcp-api в Claude Code?
Выполните команду `claude mcp add --env API_KEY_APIKEYAUTH=<API_KEY_APIKEYAUTH> --env API_BASE_URL=<API_BASE_URL> --env USE_TOOLS=<USE_TOOLS> --transport stdio mcp-api -- npx -y @fusionauth/mcp-api`, передав ключ доступа и URL стенда.
Что делает сервер mcp-api?
Он превращает методы FusionAuth в инструменты для языковой модели, позволяя запрашивать данные учётных записей и менять настройки авторизации.
Зачем задавать переменную USE_TOOLS?
Полный набор из 300 методов тратит около 200 тысяч токенов контекста. Значение retrieve,search отсекает лишнее, оставляя только чтение и экономя окно модели.
