Skip to content

v1.3.0 — MCP Bridge

Choose a tag to compare

@freddy-schuetz freddy-schuetz released this 14 Apr 07:59
0868ebf

What's new

n8n-claw can now install Skills that wrap external MCP servers — DeepWiki, Zapier, Knotie, custom bearer-auth endpoints — not just locally-hosted MCP workflows. The Library Manager had a type: "bridge" stub since the skill system shipped; this release fills it in.

Bridge Templates

  • New type: "bridge" template flavor — manifests with a bridge.mcp_url register directly in mcp_registry without importing a workflow into n8n
  • Auth supportauth_type: "none" | "bearer" | "header" per template, with plaintext token storage in mcp_registry.auth_token (consistent with how template_credentials already stores API keys)
  • Credential form integration — bridge templates with auth_token_required: true generate a one-time HTTPS form link after install; the submitted token is written to both template_credentials and mcp_registry so the inline client picks it up on the next tool call
  • Remove guard — bridge templates skip the n8n workflow delete step (no workflow exists to delete)

Inline MCP Client

  • Three clients patchedn8n-claw-agent, sub-agent-runner, background-checker all do a registry auth lookup before calling external servers, so tool calls from any context carry the correct Authorization header
  • Stateless server supportmcp-session-id is now optional in the inline client. Required for servers like DeepWiki that don't issue a session ID on initialize

Changed

  • Memory Consolidation / ErrorNotification / existing native templates are byte-identical for auth_type='none' (the default for all pre-existing registry rows) — zero behavior change when no bridge template is installed

Breaking changes

None.

Upgrade

cd n8n-claw && git pull && ./setup.sh --force

The new database migration 006_mcp_bridge.sql adds auth_type + auth_token columns to mcp_registry and is applied automatically.