Improve documentation on deployment

[carli2]

Currently I run:

$ npx n8n-mcp
Need to install the following packages:
n8n-mcp@2.10.4
Ok to proceed? (y) y

[2025-08-14T14:08:27.281Z] [n8n-mcp] [INFO] Node.js version: v22.9.0
[2025-08-14T14:08:27.282Z] [n8n-mcp] [INFO] Platform: linux x64
[2025-08-14T14:08:27.282Z] [n8n-mcp] [INFO] Attempting to use better-sqlite3...
[2025-08-14T14:08:27.286Z] [n8n-mcp] [INFO] Initializing n8n Documentation MCP server
[2025-08-14T14:08:27.287Z] [n8n-mcp] [INFO] MCP server initialized with 22 tools (n8n API: not configured)
[2025-08-14T14:08:27.288Z] [n8n-mcp] [INFO] Successfully initialized better-sqlite3 adapter
[2025-08-14T14:08:27.321Z] [n8n-mcp] [INFO] FTS5 table already exists for templates
[2025-08-14T14:08:27.322Z] [n8n-mcp] [INFO] FTS5 enabled with 0 indexed entries
[2025-08-14T14:08:27.323Z] [n8n-mcp] [INFO] Initialized database from: /home/carli/.npm/_npx/b6a381d62ce0fe56/node_modules/n8n-mcp/data/nodes.db
[2025-08-14T14:08:27.325Z] [n8n-mcp] [INFO] n8n Documentation MCP Server running on stdio transport

Now the following questions arise that I couldn't answer myself by googling:

• the INFO message says: n8n API: not configured. Where should I place the config file, what should be the content of the config file?
• on which port is this software running?

[joshwilhelmi]

Depends on where you're using it. There are instructions for setting it up in Claude, Cursor, Docker... In Claude you put your n8n server and API key in your claude_desktop_config.json, for example.

3000 by default.

[gfoust69]

Depends on where you're using it. There are instructions for setting it up in Claude, Cursor, Docker... In Claude you put your n8n server and API key in your claude_desktop_config.json, for example.

3000 by default.

You are correct, there are instructions for setting up in Claude, Cursor, Docker. But the example above @carli2 is the npx n8n-mcp usage. The instructions say run that command and press Y, that's it! However, there is no instruction on how to connect to the n8n instance that the npx command has spun up. Do you need to install n8n software? Does the npx command spin up the n8n url? what is the url if it does?

The instructions go straight from run "npx n8n-mcp", enter the api, enter the url for direct interaction. That's it. But no assistance on how to find the url, which would then be used to get the api information.

For example, run 'npx-n8n' it finishes with this information for connecting:

Editor is now accessible via:
http://localhost:5678

Press "o" to open in Browser.

When you run 'npx n8n-mcp'

[2025-09-04T15:46:29.569Z] [n8n-mcp] [INFO] Node.js version: v22.18.0
[2025-09-04T15:46:29.572Z] [n8n-mcp] [INFO] Platform: win32 x64
[2025-09-04T15:46:29.572Z] [n8n-mcp] [INFO] Attempting to use better-sqlite3...
[2025-09-04T15:46:29.598Z] [n8n-mcp] [INFO] Initializing n8n Documentation MCP server
[2025-09-04T15:46:29.602Z] [n8n-mcp] [INFO] MCP server initialized with 22 tools (n8n API: not configured)
[2025-09-04T15:46:29.604Z] [n8n-mcp] [INFO] Successfully initialized better-sqlite3 adapter
[2025-09-04T15:46:29.629Z] [n8n-mcp] [INFO] FTS5 table already exists for templates
[2025-09-04T15:46:29.630Z] [n8n-mcp] [INFO] FTS5 enabled with 0 indexed entries
[2025-09-04T15:46:29.630Z] [n8n-mcp] [INFO] Initialized database from: C:\Users\gordon\AppData\Local\npm->cache_npx\b6a381d62ce0fe56\node_modules\n8n-mcp\data\nodes.db
[2025-09-04T15:46:29.634Z] [n8n-mcp] [INFO] n8n Documentation MCP Server running on stdio transport

The editor doesn't open on http://localhost:5678.
How do we connect?