MCP n8n Quickstart

Last updated:

This guide provides a direct n8n implementation path for Revspire MCP.

Step 1: Create OAuth Connection in Revspire

  1. Go to Revspire > Setup > OAuth .
  2. Select template: n8n MCP Browser Flow (Production) .
  3. Set callback URL to your n8n callback URL.
  4. Save and copy Client ID and Client Secret .

Step 2: Configure OAuth2 Credential in n8n

Use OAuth2 Authorization Code flow with PKCE.

Set MCP URL to https://mcp.revspire.io/mcp .

Values

Auth URL: https://login.api.revspire.io/oauth/authorize
Access Token URL: https://login.api.revspire.io/oauth/token
Scope: openid profile email offline_access revspire.mcp.tools.read revspire.mcp.tools.write
Client Authentication: client_secret_post

Step 3: Test MCP Reachability

First test unauthenticated health:

GET https://mcp.revspire.io/mcp/health

Then test authenticated initialize:

POST https://mcp.revspire.io/mcp
Body:
{
  "jsonrpc": "2.0",
  "id": "1",
  "method": "initialize",
  "params": {}
}

Step 4: Call Tools from n8n HTTP Nodes

Example tool call body:

{
  "jsonrpc": "2.0",
  "id": "2",
  "method": "tools/call",
  "params": {
    "name": "dealroom.list",
    "arguments": {
      "search": "renewal",
      "page": 1,
      "page_size": 10
    }
  }
}

Best Practices

  • Use separate OAuth connections for dev, staging, and production.
  • Use least-privilege scope sets when workflows are read-only.
  • For mutation tools, pass a stable idempotency_key for retries.
  • Capture and log request_id for traceability.

Troubleshooting

  • 401/403 : token or scope mismatch, reauthorize credential.
  • 429 : reduce call burst and add backoff.
  • 504 : narrow query scope or split workflow steps.