Docs menu

Getting started

Install in your agent app

Add CLI's MCP server to Claude Code, Cursor, VS Code or any other MCP app, with one click, one line or a JSON snippet.

Explain it

CLI works inside the AI apps you already use: Claude Code, Cursor, VS Code, ChatGPT and any app that supports MCP (the standard way AI apps add tools).

How to do it: the easiest way is Give your agent one line at the top of a project page: pick your app and it fills in everything for you, including a key with a spending limit. The technical version shows the setup for each app by hand.

CLI's MCP server is the npm package @clicloud-app/mcp. Every agent app runs it the same way, with npx, and passes it your settings as environment variables. This page shows the quickest way in for each app, then how to run the server by hand.

You need a project key (clik_…) for the agent. The easiest way to get one is the dashboard's Connect an agent panel, which makes a key with a spending limit and fills it into everything below. See Connect your AI agent.

Claude Code

The plugins

There are two CLI plugins. Both add a skill that teaches Claude how to use CLI and a deploy command. See CLI in Claude for what each one sends and can't do.

clicloud connects to CLI's hosted MCP server. You sign in through your browser the first time Claude uses it; there's no key to paste and nothing runs on your machine. It has no payment tools.

/plugin marketplace add clicloud-app/claude-plugins
/plugin install clicloud@clicloud

clicloud-x402 runs the MCP server on your machine with your API key, and can pay over x402 from an agent wallet you fund, up to a limit you set.

/plugin marketplace add clicloud-app/claude-plugins
/plugin install clicloud-x402@clicloud

Claude Code asks for your CLI API key (and, optionally, a wallet and a spending limit) while it installs. Then ask Claude to "deploy this to CLI", or run /clicloud-x402:deploy.

The deploy command checks which project the key belongs to, creates a service from the folder's git remote if there isn't one, sets variables and adds a database if the code needs one, deploys, and fixes failures. It stops after three failed tries and explains what's wrong, and it never raises a spending limit or approves its own request.

One line instead

If you'd rather not install the plugin, add the server with one command in your project folder:

Terminal
claude mcp add cli -e CLI_API_URL=https://api.clicloud.app -e CLI_API_KEY=clik_… -- npx -y @clicloud-app/mcp

The dashboard's Claude Code tab writes this line with your key filled in.

Cursor

In the dashboard: on the Cursor tab, make the line, then press Add to Cursor. Cursor opens and asks to add the server, with your key already in it.

By hand: add this to .cursor/mcp.json in your project:

JSON
{
  "mcpServers": {
    "cli": {
      "command": "npx",
      "args": ["-y", "@clicloud-app/mcp"],
      "env": {
        "CLI_API_URL": "https://api.clicloud.app",
        "CLI_API_KEY": "clik_…"
      }
    }
  }
}

Then ask: "Deploy this to CLI."

VS Code

In the dashboard: on the VS Code tab, make the line, then press Add to VS Code. VS Code opens and asks to add the server.

By hand: add this to .vscode/mcp.json. VS Code calls the list servers, not mcpServers:

JSON
{
  "servers": {
    "cli": {
      "command": "npx",
      "args": ["-y", "@clicloud-app/mcp"],
      "env": {
        "CLI_API_URL": "https://api.clicloud.app",
        "CLI_API_KEY": "clik_…"
      }
    }
  }
}

Then ask Copilot in agent mode: "Deploy this to CLI."

ChatGPT

ChatGPT connects to CLI's hosted server instead of running anything locally. Add CLI from ChatGPT's apps directory, or add it by hand with the URL https://api.clicloud.app/mcp/openai, then sign in and press Allow. Secrets are entered in the dashboard, not the chat. See CLI in ChatGPT.

Any other MCP app

Most MCP apps read the same mcpServers shape as Cursor. Add the snippet from the Cursor section to your app's MCP settings; the dashboard's Other MCP apps tab writes it with your key filled in.

CLI's server is also listed in the MCP Registry as app.clicloud/mcp, so apps that browse the registry can find it by that name.

Agents that don't speak MCP can still use CLI through the skill file: see Connect your AI agent.

Run the server by hand

Terminal
CLI_API_KEY=clik_… npx -y @clicloud-app/mcp

It needs Node.js 20 or later. Its settings:

VariableWhat it is
CLI_API_KEYA project key from the dashboard. Or set a wallet instead
CLI_API_URLThe CLI server's API address. Default https://api.clicloud.app
CLI_AGENT_PRIVATE_KEYAn EVM wallet (0x hex) the agent signs in and pays with
CLI_SPEND_LIMIT_USDCThe most this server may pay over x402, in USDC. Default 0: it never pays, and asks you instead

The server also understands Solana wallets and a network choice; the full list is in MCP tools.

Using the cli command too?

The @clicloud-app/cli package also includes the MCP server as cli-mcp, so npx -y -p @clicloud-app/cli cli-mcp works. For agent apps, use npx -y @clicloud-app/mcp: it's just the server, with nothing else to install.

For tools that set this up for people

GET /v1/install on any CLI server returns every install path for that server: the npm package, the registry name, the Claude Code plugin commands and one-line command, the Cursor link and snippet, the VS Code link, and the skill file's address. It needs no token and holds no keys; add the key yourself.

API
GET /v1/install

Next steps