MCP Server Configuration

Documentation for all MCP (Model Context Protocol) servers connected to Claude Code.

Quick Reference

Config location: ~/.claude.json (the mcpServers key)
Register servers with: claude mcp add or claude mcp add-json (NEVER edit config files directly)
List servers: claude mcp list
Check one server: claude mcp get <name>
Remove: claude mcp remove <name> -s user

Documentation Index

Document	Purpose
google-workspace.md	Gmail, Google Drive, Google Calendar setup
all-servers.md	Complete inventory of every MCP server
troubleshooting.md	Common issues and fixes
slack.md	Slack MCP setup — Bearer token auth, app config, lessons learned

Critical Rule

NEVER add MCP servers by editing settings.json or mcp.json directly. Claude Code does not read mcpServers from ~/.claude/settings.json. It reads from ~/.claude.json, which is managed by the claude mcp CLI commands. Manually editing config files is the #1 cause of "server not loading" issues.