Cloptima CLI MCP Setup

What You Get

Cloptima CLI now includes an embedded MCP server. You run cloptima mcp serve locally and your AI client can call Cloptima tools over stdio without any hosted MCP endpoint.

Prerequisites

Install cloptima-cli, create a Personal Access Token in Cloptima settings, and export CLOPTIMA_ACCESS_TOKEN in your shell environment before starting your MCP client.

MCP Server Command

Use this command as the MCP server process in your client configuration.

cloptima mcp serve

Claude Desktop Example

Add an MCP server entry that launches cloptima and passes your access token via environment variables.

{
  "mcpServers": {
    "cloptima": {
      "command": "cloptima",
      "args": ["mcp", "serve"],
      "env": {
        "CLOPTIMA_ACCESS_TOKEN": "pat_..."
      }
    }
  }
}

Cursor Example

Use the same command/args pattern in Cursor's MCP settings.

{
  "mcpServers": {
    "cloptima": {
      "command": "cloptima",
      "args": ["mcp", "serve"],
      "env": {
        "CLOPTIMA_ACCESS_TOKEN": "pat_..."
      }
    }
  }
}

Cline Example

Configure Cline's MCP server entry with identical command wiring.

{
  "mcpServers": {
    "cloptima": {
      "command": "cloptima",
      "args": ["mcp", "serve"],
      "env": {
        "CLOPTIMA_ACCESS_TOKEN": "pat_..."
      }
    }
  }
}

Validation and Troubleshooting

Run cloptima version and cloptima accounts list in the same shell used by your AI client. If calls fail, verify token scope, account membership, and that cloptima is available in PATH for the MCP client process.