n8n connector
n8n-nodes-aicp is the official
n8n community node for sending chat completions through your AICP
gateway, no integration code required. It's intentionally scoped to just chat
completions; everything else (projects, routing config, policy, budgets, API keys) is
still managed from the AICP dashboard.
Install
From within n8n (self-hosted instances): Settings → Community Nodes → Install →
enter n8n-nodes-aicp.
Local development / linking against the AICP monorepo:
pnpm --filter n8n-nodes-aicp build
cd packages/n8n-nodes-aicp && pnpm link --global
cd ~/.n8n/nodes && pnpm link --global n8n-nodes-aicp # or wherever N8N_CUSTOM_EXTENSIONS points
Restart n8n and the AICP node appears in the node panel.
Credentials
Create an AICP credential in n8n with:
| Field | Value |
|---|---|
| Base URL | Your AICP gateway URL (no trailing slash) |
| API Key | An aicp-... key from your project's (or org's) API Keys page. Org-wide or project-scoped keys both work. |
Node parameters
| Parameter | Description |
|---|---|
| Model | auto (recommended: AICP's routing engine picks the best model) or a specific model ID |
| Messages | One or more { role, content } pairs; build a system prompt plus conversation history |
| Simplify Output | On by default: returns { content, model, finishReason, usage } instead of the raw API response |
| Additional Options → Temperature / Max Tokens / Provider | Optional. Provider pins a specific upstream provider; combine with Model auto to pick the best model from that provider |
Which models can I use?
The same catalog as everywhere else. See Providers & Models for the full list, and the dashboard's Model Catalog tab for the live view (providers your admin has connected platform-wide, plus any you've connected yourself via BYOK).