Connect Your Agent
Set up the MCP server in under 3 minutes
Quick Start3 min setup
1
Get an API key
Go to Service Accounts and create one with your required scopes. Copy the API key (shown once).
2
Add MCP server to your agent
claude mcp add acp -- python3 path/to/mcp-server/server.py
Then set your key:
export ACP_API_KEY="your-key"3
Done
Ask your agent: “list my ACP projects” — 31 governance tools are now available.
Personalized Setup
Sign in to see your service accounts, get pre-filled config, and test your connection.
Claude Desktop Configuration
Add to claude_desktop_config.json:
{
"mcpServers": {
"acp": {
"command": "python3",
"args": ["path/to/mcp-server/server.py"],
"env": {
"ACP_API_KEY": "<your-api-key>",
"ACP_BASE_URL": "https://controller.limitedview.co.uk/api"
}
}
}
}Cursor Configuration
Add to .cursor/mcp.json in your project root:
// Cursor MCP setup (.cursor/mcp.json)
{
"mcpServers": {
"acp": {
"command": "python3",
"args": ["path/to/mcp-server/server.py"],
"env": {
"ACP_API_KEY": "<your-api-key>",
"ACP_BASE_URL": "https://controller.limitedview.co.uk/api"
}
}
}
}Codex / OpenAI Agents
Codex connects via stdio like Claude Code. Set the env vars and run:
# Codex / ChatGPT MCP setup # 1. Install the MCP server pip install mcp httpx pydantic # 2. Set environment variables export ACP_API_KEY="<your-api-key>" export ACP_BASE_URL="https://controller.limitedview.co.uk/api" # 3. Run the server (Codex connects via stdio) python3 mcp-server/server.py
For ChatGPT Custom GPTs, import the OpenAPI spec as an Action:
# For ChatGPT Custom GPTs / Actions: # Use the OpenAPI spec directly instead of MCP: # # OpenAPI spec URL: # https://controller.limitedview.co.uk/openapi/ai-control-plane-v1.yaml # # Authentication: API Key (Custom header) # Header name: X-Api-Key # Value: <your-api-key> # # Import the spec as a ChatGPT Action to enable # all ACP endpoints as GPT capabilities.
Docker Setup
services:
acp-mcp:
image: python:3.12-slim
volumes:
- ./mcp-server:/app
working_dir: /app
environment:
- ACP_API_KEY=${ACP_API_KEY}
- ACP_BASE_URL=https://controller.limitedview.co.uk/api
command: python3 server.py
stdin_open: trueSecurity Details
- Input validation on all parameters (path traversal protection)
- Output sanitization (API keys, tokens, and secrets automatically redacted)
- HMAC-SHA256 signing on audit traces and financial data
- Write confirmation required for all mutations
- Rate limiting per operation category
- Stdio transport only (no network surface)
- Credentials stored locally with restrictive file permissions (600)
- All downloadable artifacts are signed with companion
.sig.json
Troubleshooting
Server says “not_configured”: Run the acp_setup tool with your API key, or set ACP_API_KEY in your environment.
401 Unauthorized: The API key may be expired or revoked. Generate a new one from Service Accounts.
Connection refused: Check that ACP_BASE_URL points to https://controller.limitedview.co.uk/api.
Missing tools: Ensure mcp>=1.26.0 and httpx>=0.27.0 are installed: pip install -r requirements.txt