Connect Your AI to Carpathian

An agent is how your AI works on your Carpathian account. You decide what it can do, where it can do it, and whether it asks you first.

Before you start

1. Turn on two-factor authentication for your account under Settings > Security.
2. Turn on Agents under Services. It has no charge!

Step 1: Create the agent

1. Open Agents in the dashboard and click New agent.
2. Give it a name you will recognize, such as "Claude on my laptop".
3. Pick when it expires, or leave it to never expire.

Step 2: Choose what it can do

1. Tick what the agent may do, such as viewing servers or editing firewall rules, or click Select all.
2. Pick the servers, server groups and domains it can reach, or choose all of them.

The agent can never do more than you can do yourself.

Step 3: Choose how much it does on its own

• Read only: it looks, and changes nothing.
• Ask: it asks you before every change.
• Auto: it makes changes on its own, and asks you before it deletes anything.
• Full auto: it does everything on its own, deletes included. You confirm this in a popup.

Step 4: Copy the address and the key

The last step shows two things:

• The address, which an AI app such as Claude or Cursor connects to.
• The key, which your own program uses. It is shown once, so copy it now.

Connect Claude, Cursor or another AI app

1. In the app, add a new MCP server. Claude calls this a custom connector.
2. Paste the address from Step 4.
3. A Carpathian page opens. Sign in, pick your agent, and approve.

An AI app does not need the key.

Connect your own program

1. Keep the key on your server, the same way you keep a password.
2. Have your program send the key with every request to the address, as a Bearer token in the Authorization header.
3. Never put the key in a website, a browser extension or a phone app, where anyone could read it.

When the agent asks you

When the agent needs your approval, Claude and other apps that support it ask you right in the app. Otherwise the change waits at the top of the Agents page, where you approve or decline it. Changes from your own program always wait on the Agents page.

To approve a delete, type the name of what it removes.

Stop an agent

On the agent's page you can disconnect an app, revoke a key, turn the agent off, or delete it. Each one takes effect straight away.

Set up your first agent

Open Agents at https://carpathian.ai/dashboard/agents to create one.

New to Carpathian? Create an account at https://carpathian.ai/signup.