MCP-сервер CX Codex

Nhost — MCP-сервер для Claude Code: работа с данными

Q: Как установить Nhost в Claude Code?

Создайте `run-mcp.toml`, задайте `MCP_GRAPHQL_ENDPOINT`, `MCP_AUTH_URL` и остальные нужные параметры, затем запустите `nhost up --run-service run-mcp.toml`. Для авторизации через Nhost Auth включите CIMD.

Q: Как ограничить доступ ассистента к данным?

Настройте права роли в GraphQL и передайте её через `--enforce-role`. Сервер отклонит токены с другой ролью.

MCP-сервер подключает ИИ-ассистента к GraphQL API проекта Nhost. Пользователь проходит авторизацию, а доступ к данным ограничивают его права.

Открыть на GitHub

Что делает Nhost

Сервер даёт ассистенту три инструмента: изучить GraphQL-схему, выполнить запрос на чтение или изменить данные через мутацию. При запуске он получает краткое описание схемы и передаёт его клиенту как контекст. Для работы нужен адрес GraphQL API.

Авторизация проходит через Nhost Auth по OAuth2; запросы идут с JWT пользователя, а GraphQL применяет его права на строки и столбцы. CIMD нужно включить. Это повод проверить настройки доступа до подключения: мутации могут создавать, менять и удалять данные. Флаг --enforce-role позволяет принимать токены только с заданной ролью.

Для локального запуска добавьте run-mcp.toml с адресами GraphQL и авторизации, затем выполните nhost up --run-service run-mcp.toml. В конфигурации также задаются адрес сервиса, порт и роль. Сервер поддерживает Claude Code, Codex, Cursor, GitHub Copilot, Windsurf (Devin Desktop), Cline и Zed.

Какие задачи решает

дать ассистенту доступ к данным проекта через GraphQL
проверить схему GraphQL перед составлением запросов
читать данные с правами авторизованного пользователя
ограничить доступ ассистента заданной ролью
создавать и менять записи через GraphQL-мутации

Примеры запросов агенту

Покажи схему GraphQL моего проекта и доступные операции.
Найди записи, которые доступны моему пользователю, и объясни их поля.
Создай запись через GraphQL-мутацию с такими данными: ...

Как установить Nhost

Установка

Команды запуска нет в реестре MCP — смотрите README репозитория

По шагам, с командами для каждой платформы: Как подключить MCP-сервер: Claude Code, Codex, Cursor, VS Code, Gemini CLI и другие

Вопросы о Nhost

Как установить Nhost в Claude Code?

Создайте run-mcp.toml, задайте MCP_GRAPHQL_ENDPOINT, MCP_AUTH_URL и остальные нужные параметры, затем запустите nhost up --run-service run-mcp.toml. Для авторизации через Nhost Auth включите CIMD.

Что делает Nhost MCP-сервер?

Он даёт MCP-клиенту инструменты для чтения GraphQL-схемы, выполнения запросов и мутаций. GraphQL применяет права пользователя из JWT.

Как ограничить доступ ассистента к данным?

Настройте права роли в GraphQL и передайте её через --enforce-role. Сервер отклонит токены с другой ролью.