Claude Codex Mcp Starter

AI Assistant Documentation Hub

A comprehensive guide for integrating AI assistants into your development workflow. These templates help establish consistent, effective collaboration between different AI models and human developers.

📚 Documentation Structure

Core Guidelines

• **[CLAUDE.md](./CLAUDE.md)** - Guidelines for Claude Code and similar AI assistants

  • Root cause analysis methodology
  • Common mistakes and how to avoid them
  • Multi-model collaboration patterns
  • MCP server integration (when available)
  • Project-specific configuration template

• **[AGENTS.md](./AGENTS.md)** - Multi-agent collaboration framework

  • Agent roles and strengths
  • Hand-off protocols between assistants
  • Task delegation patterns
  • Collaboration workflows

• **[MCP_SETUP.md](./MCP_SETUP.md)** - MCP server setup guide

  • One-line Codex setup
  • Adding other MCP servers
  • Security options
  • Troubleshooting

Configuration Examples

• mcp-config-example.json - Simple MCP config template
• .env.example - Environment variables template

🚀 Quick Start

1. Enable MCP Integration (One Command!)

# Install Codex CLI (choose your preferred method)
npm install -g @openai/codex       # via npm
brew install --cask codex          # via Homebrew (macOS)

# Sign in with your ChatGPT account (Plus/Pro/Team/Edu/Enterprise plans)
codex  # then select "Sign in with ChatGPT"
# OR set your OpenAI API key for API key auth:
# export OPENAI_API_KEY=sk-...

# Add Codex MCP server to Claude (macOS/Linux)
claude mcp add codex -s user -e OPENAI_API_KEY=$OPENAI_API_KEY -- codex mcp -c model=gpt-5.3 -c model_reasoning_effort="high"

# Windows PowerShell variant
claude mcp add codex -s user -e OPENAI_API_KEY=$env:OPENAI_API_KEY -- codex mcp -c model=gpt-5.3 -c model_reasoning_effort="high"

# Restart Claude Desktop - Done! 🎉

2. Quick Smoke Test (60 seconds)

Test the integration immediately:

1. I