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.
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@clicloudclicloud-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@clicloudClaude 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:
claude mcp add cli -e CLI_API_URL=https://api.clicloud.app -e CLI_API_KEY=clik_… -- npx -y @clicloud-app/mcpThe 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:
{
"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:
{
"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
CLI_API_KEY=clik_… npx -y @clicloud-app/mcpIt needs Node.js 20 or later. Its settings:
| Variable | What it is |
|---|---|
CLI_API_KEY | A project key from the dashboard. Or set a wallet instead |
CLI_API_URL | The CLI server's API address. Default https://api.clicloud.app |
CLI_AGENT_PRIVATE_KEY | An EVM wallet (0x hex) the agent signs in and pays with |
CLI_SPEND_LIMIT_USDC | The 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.
GET /v1/installNext steps
- Choose what the agent may do and spend: Agent permissions and limits.
- The full tool list: MCP tools.