Help center menu

AI TOOLS · MCP

Run your automations from AI tools

AIVane is an MCP server. Connect Claude, ChatGPT, Claude Code, Codex, Cursor, VS Code or another MCP client, and the AI can find your automations, run one with the inputs it needs, read the results and stop a run. Your automations do the clicking; the AI decides when to use them.

  • Claude Code
  • Codex
  • Cursor
  • Any MCP client

What the AI can do

The desktop and cloud servers share four tools, so the AI works the same way wherever your automation runs. The cloud server adds list_runs.

  • list_automationsFinds the automations you made available, with the inputs each one needs and where it can run.
  • run_automationStarts an automation with named inputs and waits for the result. A longer run returns a run ID to check later.
  • get_runReads a run's status, outputs, files and error details, and on request a screenshot.
  • stop_runAsks a running automation to stop and reports what happened.
  • list_runsLists the recent runs that were started through MCP (cloud server only).

On your computer or in AIVane Cloud

The two MCP servers
Desktop appAIVane Cloud
Runs happenOn your computer, with your browser and desktop appsIn AIVane Cloud, or on your own registered devices with Business
Automations it seesThe ones you expose to AI toolsAutomations in your AIVane account
Connect withA command the desktop app gives youThe address https://app.aivane.net/mcp and a sign-in; no token needed
Works offlineYes, no account neededNeeds an internet connection

Add one of the two to an AI tool, not both: they use the same tool names.

Connect AI tools to the desktop app

  1. In the AIVane desktop app, open Settings → AI tools (MCP).
  2. Turn on Allow AI tools to use AIVane.
  3. Under Automations AI tools can use, choose Expose to AI tools for each automation the AI may run. Add a Description for AI so it knows when to use it.
  4. Under Connect an AI tool, copy the command for Claude Code, or the snippet for Codex (~/.codex/config.toml) or Cursor (mcp.json), and add it to your tool. It starts AIVane's helper on your computer.

Use the desktop app installer from aivane.net/download for AI tools. The Microsoft Store edition moves to a new folder with each update, so it offers no connection command.

Connect AI tools to AIVane Cloud

The recommended way is to connect by address and sign in (OAuth). You do not create or paste a token. The server address is https://app.aivane.net/mcp. When your AI tool connects, it opens an AIVane permission page: choose Allow. The Allow risky automations box on that page is optional and off by default. You can review or revoke each connected app in app.aivane.net under Settings → AI tools → Authorized apps.

Claude Code

claude mcp add --transport http aivane https://app.aivane.net/mcp

Then run /mcp in Claude Code and choose Authenticate.

claude.ai and Claude Desktop

Open Settings → Customize → Connectors → Add custom connector, enter a name and the address, choose Connect, then Allow. This also covers Claude Code in the Claude desktop app. A connector added once on claude.ai is available in Claude Desktop too.

ChatGPT

Open Plugins → Add → Add custom MCP server. Set Server URL to the address and Authentication to OAuth, tick the risk acknowledgement, choose Create as a plugin, then Continue to AIVane and Allow. Developer mode is not needed.

VS Code

Sign in to GitHub Copilot, run Chat: Open Customizations, open MCP Servers, choose + (User) and HTTP, and enter the address. Start the server and sign in when asked.

Cursor

Add this to ~/.cursor/mcp.json, then open Customize in the sidebar, choose MCPs, select aivane and sign in.

{
  "mcpServers": {
    "aivane": {
      "url": "https://app.aivane.net/mcp"
    }
  }
}

Scripts, CI and clients without sign-in

  1. Sign in at app.aivane.net and open Settings → AI tools.
  2. Under Create an access token, give the token a name, for example the tool and computer it is for, and choose Create token. Select Allow risky automations only if this tool may run automations that otherwise ask for your confirmation.
  3. Copy the token right away: it is shown only once.
  4. Send it as Authorization: Bearer <token>, for example with one of these setups, replacing <token> with your token.

Claude Code

claude mcp add --transport http aivane https://app.aivane.net/mcp --header "Authorization: Bearer <token>"

Codex (~/.codex/config.toml)

[mcp_servers.aivane]
url = "https://app.aivane.net/mcp"
http_headers = { Authorization = "Bearer <token>" }

Cursor (mcp.json)

{
  "mcpServers": {
    "aivane": {
      "url": "https://app.aivane.net/mcp",
      "headers": {
        "Authorization": "Bearer <token>"
      }
    }
  }
}

A client that accepts only a URL can use the key URL shown next to the token in Settings → AI tools. Keep that URL private, because anyone who has it can use the token. You can have up to 10 tokens and revoke any of them in the same place.

The cloud server sees automations that have a cloud copy in your AIVane account. To use one you made in the desktop app, upload it to your account first. Cloud runs use your plan's cloud minutes or credits. Running on your own devices through the cloud server needs Business.

Good to know

  • A run that takes longer than the wait returns a run ID. Ask the AI to check it with get_run; the cloud server waits up to about 45 seconds.
  • list_runs lists the recent runs that were started through MCP.
  • When a run ends with an unknown result, check what happened in AIVane before running it again.

AI tools questions

Which AI tools work with AIVane?

Any MCP client that can connect to an HTTP server: Claude (claude.ai, Claude Desktop, Claude Code), ChatGPT, VS Code, Cursor and others connect by address with sign-in, no token. Clients that cannot sign in can use an access token. For the desktop app, the settings page gives ready-made setups for Claude Code, Codex and Cursor.

Which plans include it?

Every plan, including Free, can connect AI tools to the desktop app. Cloud runs started by an AI tool use your plan's cloud run minutes, the same as runs you start yourself. Running on your own registered devices through the cloud server is part of Business.

Can the AI run anything it wants on my computer?

It runs automations, not arbitrary commands: only the ones you expose to AI tools, with the same steps you can read in AIVane. An automation marked as risky needs your consent first. On the desktop, run it once in AIVane and confirm the notice; in the cloud, only a connection or token that has Allow risky automations switched on can run it.

How do I stop an AI tool from using my account?

On the desktop, turn off Allow AI tools to use AIVane. For the cloud server, revoke the app in Settings → AI tools → Authorized apps, or revoke its token in the same place; the tool stops working immediately.

YOUR OWN TASK

Want help automating your own task?

Our first users can ask for hands-on help: one website task, one sheet, and a week of watching it run.

Get help automating a task ↗