Grok Codex
Click on "Deploy Server".
Wait a few minutes for the server to deploy. Once ready, it will show a "Started" state.
In the chat, type
@followed by the MCP server name and your instructions, e.g., "@Grok Codex Ask Grok: explain quantum entanglement in simple terms"
That's it! The server will respond to your query, and you can continue using it as needed.
Here is a step-by-step guide with screenshots.
Grok Codex
버전 0.2.0 · OpenAI Codex Desktop / GUI용 플러그인 + MCP stdio leaf.
xAI Grok를 Codex에서 직접 호출합니다. 오케스트레이션 플러그인의 leaf로 쓰기 좋게 얇게 만들었습니다.
비공식 프로젝트. Grok / xAI 상표는 xAI 소유입니다.
Hermes가 아닙니다. hermes-agent에서 xAI 엔드포인트·헤더·Responses 아이디어만 참고. docs/SOURCE_MAP.md
빠른 시작
codex plugin marketplace add "/path/to/Grok Codex"
codex plugin add grok-codex@grok-codex
python3 scripts/grok_codex_consent.py grant --i-understand-and-consent
export XAI_API_KEY=xai-...
python3 scripts/grok_codex_doctor.pyRelated MCP server: grok-build-mcp
구독 로그인 (SuperGrok / X Premium+)
기본 인증은 xAI device-code OAuth (Hermes xai-oauth와 동일 패턴).
python3 scripts/grok_codex_consent.py grant --i-understand-and-consent
python3 scripts/grok_codex_login.py interactive
# 브라우저에서 accounts.x.ai 승인
python3 scripts/grok_codex_login.py statusMCP: grok_codex_login_start → 브라우저 승인 → grok_codex_login_complete
API 키 강제: GROK_CODEX_AUTH_MODE=api_key + XAI_API_KEY
MCP 도구
Tool | 역할 |
| 동의 상태 |
| API 키 준비 여부 |
| Chat Completions (기본) 또는 Responses |
| 모델 목록 |
| 로컬 진단 |
grok_codex_chat 옵션:
api_mode:chat(기본) |responsessession_id: 대화 친화 캐시용 (x-grok-conv-id)
환경 변수
변수 | 의미 |
| xAI API 키 |
| 기본 |
| 프로세스 단위 동의 |
| 기본 모델 |
|
|
| 설정 디렉터리 |
개발
python3 -m venv .venv
.venv/bin/pip install -e '.[dev]'
.venv/bin/pytest라이선스
Available Tools
9 toolsgrok_codex_chatC
Chat with Grok. Prefers SuperGrok OAuth; falls back to XAI_API_KEY.
Inputs: model, prompt, system, messages, +3 more.
grok_codex_consent_statusA
Read explicit-consent state. Cannot grant consent.
Inputs: no named parameters.
grok_codex_doctorB
Quick local diagnosis: consent, credentials, default model.
Inputs: no named parameters.
grok_codex_list_modelsA
List curated (and optionally live) models.
Inputs: probe.
grok_codex_login_completeA
Poll until device authorization completes; saves tokens.
Inputs: no named parameters.
grok_codex_login_startC
Start xAI device-code OAuth (SuperGrok / Premium+). Returns verification URL.
Inputs: open_browser.
grok_codex_login_statusA
SuperGrok / xAI OAuth login status (no secrets).
Inputs: no named parameters.
grok_codex_logoutA
Delete local SuperGrok OAuth tokens (does not revoke on xAI).
Inputs: no named parameters.
grok_codex_provider_statusB
Check credentials and readiness without exposing secrets.
Inputs: no named parameters.
Tool Schema Changelog
Recent tool additions, removals, and schema changes observed during successful MCP inspections.
Loading tool schema changelog…
TDQS
Scored across 9 tools
Each tool has a clearly distinct purpose: chat, auth flow steps, consent check, diagnosis, model listing, and provider status. No overlap in functionality despite some status-oriented tools.
All tools share the prefix 'grok_codex_' and mostly follow noun or verb_noun patterns. Minor inconsistency: 'logout' breaks the 'login_*' pattern of the auth group.
9 tools is well-scoped for an AI chat assistant with authentication needs. Each tool earns its place, covering chat, auth lifecycle, status checks, and model listing.
The tool set covers the obvious needs: chatting, authentication (start/complete/status/logout), consent management, diagnosis, provider status, and model listing. No dead ends for core workflows.
Maintenance
Related MCP Connectors
MCP server for OpenAI API (chat completions, image generation, embeddings) via AceDataCloud
MCP server for AI dialogue using various LLM models via AceDataCloud
Shared memory MCP server for Claude Code, Codex, Gemini CLI and Cursor. Cited, editable.
MCP server for Grok Imagine AI video generation
Related MCP Servers
- AlicenseAqualityBmaintenanceUse XAI's latest api functionalities with Grok MCP. It supports image understanding and generation, live search, latest models and more.2255MIT
- AlicenseAqualityDmaintenanceMCP server that wraps the Grok CLI to enable code review, adversarial testing, and chat with xAI's Grok model, integrating into any MCP host as a peer reviewer, adversary, and consultant.4113 npm11MIT
- AlicenseNot gradedqualityCmaintenanceMCP server for xAI Grok API with 19 tools for chat, web and X search, session management, tool chaining, image and video generation, and documentation.2MIT
- AlicenseAqualityBmaintenanceAn MCP server for Grok (xAI) that enables chat, reasoning, vision, and video generation using the AceDataCloud API.81MIT