Pea-sy Does It
Setup guides
How to add a server in each app, how to test it, and how to fix it when it will not start.
Pick your app
Each guide starts with where the config goes, then the exact steps.
- Claude Code
claude mcp addLocal serversRemote URLs - Claude Desktop
claude_desktop_config.jsonLocal serversRemote URLs - Cursor
~/.cursor/mcp.jsonLocal serversRemote URLs - VS Code
.vscode/mcp.jsonLocal serversRemote URLs - Codex
~/.codex/config.tomlLocal serversRemote URLs - ChatGPT
chatgpt.com/pluginsLocal serversRemote URLs
Using Cursor and cannot find the file? Where Cursor keeps mcp.json.
Three Peas in a Pod
Any server, any app, three steps
- 1Find a serverBrowse the shelf and open the server you want.
- 2Copy your app’s tabEvery server page has a tab per app with the exact config or command.
- 3Paste, restart, askSave it where your guide says, restart the app, and ask for something the server does.
Pick Your Pod
What do you want to do?
- Understand what an MCP server isWhat is an MCP server?
- Choose between local and remoteRemote or local: two ways to run an MCP server
- Use a URL in an app that wants a commandmcp-remote: use a remote MCP server in any app
- Test a server before adding itTesting an MCP server with MCP Inspector
- Fix a server that will not startFixing MCP server errors
- Check a server is safe to installChecking an MCP server before you install it
Every guide
Plant It in Your App
Set up your app
Where servers go in each app, with configs you can copy.
Pea-sics First
How MCP works
What a server is, and the two ways to run one.
Peas of Mind
Test, fix and stay safe
Prove a server works, fix the errors, and check it before you trust it.
Pea-k at a Glance
Where each app keeps its servers
The same server needs a slightly different shape in each app. Every server page on MCP Shelf has a tab per app with the exact config.
| App | Where servers go | Format | Remote URLs | Local commands |
|---|---|---|---|---|
| Claude Code | claude mcp add, or .mcp.json in a project | "mcpServers" | Yes, with "type": "http" | Yes |
| Claude Desktop | claude_desktop_config.json, or Settings → Connectors | "mcpServers" | As connectors | Yes |
| Cursor | ~/.cursor/mcp.json or .cursor/mcp.json | "mcpServers" | Yes | Yes |
| VS Code | .vscode/mcp.json, or MCP: Add Server | "servers", each with a "type" | Yes | Yes |
| Codex | ~/.codex/config.toml, or codex mcp add | TOML: [mcp_servers.NAME] | Yes (Streamable HTTP) | Yes |
| Windsurf | ~/.codeium/windsurf/mcp_config.json | "mcpServers", "serverUrl" for URLs | Yes | Yes |
| ChatGPT on the web | chatgpt.com/plugins | A URL, no file | Yes, as plugins | No |