csh
/
playbook
1
1
Fork 0
Code Issues Pull Requests Actions Packages Projects Releases Wiki Activity
playbook/outfitter-agents/plugins/outfitter/skills/codex-config/references/mcp-servers.md

2.2 KiB
Raw Blame History

MCP Server Configuration for Codex

Detailed examples and patterns for configuring MCP servers in Codex CLI.

Basic Structure

[mcp_servers.server-name]
command = "npx"
args = ["-y", "@package/mcp-server"]
enabled = true
tool_timeout_sec = 60.0

[mcp_servers.server-name.env]
API_KEY = "your-key"

Common MCP Servers

Context7 (Documentation Lookup)

[mcp_servers.context7]
command = "npx"
args = ["-y", "@upstash/context7-mcp", "--api-key", "YOUR_KEY"]

Firecrawl (Web Scraping)

[mcp_servers.firecrawl]
command = "npx"
args = ["-y", "firecrawl-mcp"]

[mcp_servers.firecrawl.env]
FIRECRAWL_API_KEY = "YOUR_KEY"

Graphite (Stacked PRs)

[mcp_servers.graphite]
command = "gt"
args = ["mcp"]

Linear (Project Management)

[mcp_servers.linear]
command = "npx"
args = ["-y", "mcp-remote@latest", "https://mcp.linear.app/sse"]

PostgreSQL

[mcp_servers.postgres]
command = "npx"
args = ["-y", "@modelcontextprotocol/server-postgres"]

[mcp_servers.postgres.env]
POSTGRES_CONNECTION_STRING = "postgresql://localhost/mydb"

Filesystem

[mcp_servers.filesystem]
command = "npx"
args = ["-y", "@modelcontextprotocol/server-filesystem", "/path/to/directory"]

Configuration Options

Timeout Settings

[mcp_servers.slow-server]
command = "slow-command"
args = []
tool_timeout_sec = 120.0  # 2 minutes

Disabling Servers

[mcp_servers.disabled-server]
command = "some-command"
args = []
enabled = false

Environment Variables

[mcp_servers.custom-server.env]
API_KEY = "secret"
DEBUG = "true"
HOME = "/custom/home"

Multiple Servers Example

# Documentation
[mcp_servers.context7]
command = "npx"
args = ["-y", "@upstash/context7-mcp"]

# Project management
[mcp_servers.linear]
command = "npx"
args = ["-y", "mcp-remote@latest", "https://mcp.linear.app/sse"]

# Version control
[mcp_servers.graphite]
command = "gt"
args = ["mcp"]

# Web scraping
[mcp_servers.firecrawl]
command = "npx"
args = ["-y", "firecrawl-mcp"]

[mcp_servers.firecrawl.env]
FIRECRAWL_API_KEY = "YOUR_KEY"

Verification

# List configured MCP servers
codex mcp list

# Test specific server
codex mcp test server-name