> ## Documentation Index
> Fetch the complete documentation index at: https://docs.opper.ai/llms.txt
> Use this file to discover all available pages before exploring further.

# n8n

> Install the Opper community node and use any Opper model in your n8n AI workflows

[n8n](https://n8n.io) is a workflow automation platform with AI nodes built in. Opper ships a community node, so Opper models appear as a native chat-model sub-node rather than a generic HTTP request.

**Requirements:** n8n 1.94.0 or later, Node.js 20.15+.

## Setup

<Steps>
  <Step title="Install the community node">
    **Settings → Community Nodes → Install**, then enter:

    ```
    @opperai/n8n-nodes-opper
    ```
  </Step>

  <Step title="Add the credential">
    Create an **Opper API** credential:

    | Field        | Value                                      |
    | ------------ | ------------------------------------------ |
    | **API Key**  | Your Opper API key (starts with `op-`)     |
    | **Base URL** | `https://api.opper.ai/v3/compat` (default) |

    The credential test validates connectivity through Opper's OpenAI-compatible `GET /models` endpoint.
  </Step>

  <Step title="Use it in a workflow">
    Add an **AI Agent** node (or **Basic LLM Chain**, or anything else that accepts a language-model connection) and attach **Opper Chat Model** as its model sub-node.
  </Step>
</Steps>

## Choosing a model

The Opper Chat Model node lists the catalog fetched with your credential, filtered by your [model access rules](/control-plane/rules/model-access). Agent nodes need tool calling — pick a model the [catalog](/capabilities/models) marks with the `tools` capability.

## Attributing usage per workflow

n8n instances usually run many workflows against one credential. Tag the traffic so you can tell them apart in Opper analytics — see [Tags and usage attribution](/build/gateway/usage-attribution).

## Troubleshooting

<AccordionGroup>
  <Accordion title="The node doesn't appear after installing">
    n8n loads community nodes at startup. Restart the instance after installing.
  </Accordion>

  <Accordion title="Community nodes are disabled">
    Self-hosted n8n gates community nodes behind an environment flag, and some managed plans don't allow them at all. Check your instance settings.
  </Accordion>

  <Accordion title="The credential test fails">
    It calls `GET /models`. A failure usually means the key is wrong, or the base URL has an extra path segment — it should be exactly `https://api.opper.ai/v3/compat`.
  </Accordion>
</AccordionGroup>

## Related

<CardGroup cols={2}>
  <Card title="Tags and usage attribution" icon="tag" href="/build/gateway/usage-attribution">
    Split usage per workflow or tenant.
  </Card>

  <Card title="All integrations" icon="plug" href="/integrations/overview">
    Every app that runs on Opper.
  </Card>
</CardGroup>