Getting Started

Follow these steps to start using Natoma's MCP platform:

Step 1: Install Natoma Gateway via your terminal:

npm i @natomalabs/natoma-mcp-gateway

Step 2: Login or register on https://app.natoma.ai/login

Step 3: Click on Add Server

Step 4: Explore our Server Registry and install a server.

Step 5: Configure credentials while installing a server:

Step 6: When the server is installed correctly, we will generate the config to be pasted in your claude_desktop_config.json

Step 7: Find your Claude client config file

Open up the Claude menu on your computer and go to the developer settings.

Please note that these are not the Claude Account Settings found in the app window itself

Follow the steps below for macOS:

• Click on setting in the menu bar

• Click on “Developer” in the left-hand bar of the Settings pane, and then click on “Edit Config”:

Step 8: Locate the config file

The above steps will create a configuration file at:

• macOS: ~/Library/Application Support/Claude/claude_desktop_config.json

• Windows: %APPDATA%\Claude\claude_desktop_config.json

Step 9: Paste the config from Natoma's MCP platform

Open up the claude_desktop_config.json file and if it’s empty then add this json blob:

{
“mcpServers": {}
}

Now paste the config generated after the server installation on the Natoma's MCP platform. Paste the config within the mcpServers Object mentioned above.

Example of config generated for Slack MCP server on Natoma's MCP platform:

{
	"slack": {
		"command": "npx",
			"args": [
				"@natomalabs/natoma-mcp-gateway"
			],
			"env": {
				"NATOMA_MCP_API_KEY": "XXX",
				"NATOMA_MCP_SERVER_INSTALLATION_ID": "XXX"
			}
		}
	}
}

Example of a final claude_desktop_config.json

{
 "mcpServers": {
   "slack": {
     "command": "npx",
     "args": [
       "@natomalabs/natoma-mcp-gateway"
     ],
     "env": {
       "NATOMA_MCP_API_KEY": "XXX",
       "NATOMA_MCP_SERVER_INSTALLATION_ID": "XXX"
     }
   }
 }
}

Example of a pre-populated config with existing servers:

{
 "mcpServers": {
   "slack": {
     "command": "npx",
     "args": [
       "@natomalabs/natoma-mcp-gateway"
     ],
     "env": {
       "NATOMA_MCP_API_KEY": "XXX",
       "NATOMA_MCP_SERVER_INSTALLATION_ID": "uniqueId-1"
     }
   },
"okta": {
     "command": "npx",
     "args": [
       "@natomalabs/natoma-mcp-gateway"
     ],
     "env": {
       "NATOMA_MCP_API_KEY": "XXX",
       "NATOMA_MCP_SERVER_INSTALLATION_ID": "uniqueId-2"
     }
   }
 }
}

Step 9: Restart Claude and start building 🚀

Save your claude_desktop_config.json and restart Claude. Voila! You should start seeing your tools populated when you hover the hammer on bottom right and you are all set.