GuidesMCP
Tutorial: connecting an MCP server to Claude Desktop
1. The declaration
{
"mcpServers": {
"stock": {
"command": "node",
"args": ["/Users/you/mcp-stock/build/index.js"],
"env": { "STOCK_API_KEY": "..." }
}
}
}
2. The steps
- 1Open the configurationSettings, Developer, edit configuration.
- 2Declare the serverCommand, arguments with an absolute path, variables.
- 3RestartQuit the app completely, then relaunch it.
- 4CheckThe server's tools appear in the conversation.
3. Test it
Ask Claude for something that needs the tool (“what is the stock of TSH-042?”). The app shows the call and asks your permission before running it.
Common errors
| Symptom | Likely cause |
|---|---|
| No tools | Invalid JSON, or app not restarted |
| Server in error | Relative path, or node not found |
| Tool fails | Missing environment variable |
Before this: build the server in TypeScript.
Frequently asked questions
- Where is the configuration file?
- In Claude Desktop, Settings, Developer section, edit configuration button: it opens the right file, on Mac and Windows alike.
- My server does not show up, what should I check?
- That the JSON is valid, the path is absolute, the command runs on its own in a terminal, then read the MCP logs listed in the developer settings.
- How do I pass an API key to the server?
- In the env field of its declaration. The file stays on your machine: do not share it as is.