GuidesMCP

Tutorial: connecting an MCP server to Claude Desktop

By the Banzai Labs teamUpdated on 2 min read

{"mcpServers": {"crm": { … }}}claude_desktop_config.jsoncrm tool usedOne settings file, one restart, and Claude sees your tools
Declared in the configuration file, the MCP server shows up in Claude Desktop.

1. The declaration

{
  "mcpServers": {
    "stock": {
      "command": "node",
      "args": ["/Users/you/mcp-stock/build/index.js"],
      "env": { "STOCK_API_KEY": "..." }
    }
  }
}

2. The steps

  1. 1Open the configurationSettings, Developer, edit configuration.
  2. 2Declare the serverCommand, arguments with an absolute path, variables.
  3. 3RestartQuit the app completely, then relaunch it.
  4. 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.

Read next

All guides