OSVauco/opax-mcp/README.md

58 lines
1.7 KiB
Markdown

# opax-mcp
OPAX MCP Server — eksponerer hele Vauco OPAX-plattformen som MCP-tools.
## Tools
| Kategori | Tools |
|----------|-------|
| **Billing** | `get_billing_summary`, `get_billing_forecast`, `get_billing_credits`, `get_billing_anomalies`, `get_billing_history`, `get_billing_budget`, `set_billing_budget` |
| **Onboarding** | `create_invite`, `list_customers` |
| **Notify** | `send_webhook`, `send_email`, `send_sms`, `get_notify_channels` |
| **Agents** | `run_jason`, `run_emma` |
| **Platform** | `get_health`, `get_build_status`, `get_state`, `get_telemetry`, `run_terminal` |
| **GitHub** | `list_commits`, `get_file`, `list_open_issues`, `create_github_issue`, `push_file` |
## Lokalt (stdio)
```bash
cd opax-mcp
pip install -r requirements.txt
export OPAX_BASE_URL=https://opax.vauco.no
export GITHUB_PAT=<ditt-token>
python server.py
```
## MCP-klient konfig (Cursor / Claude Desktop)
```json
{
"mcpServers": {
"opax": {
"command": "python",
"args": ["/path/to/OSVauco/opax-mcp/server.py"],
"env": {
"OPAX_BASE_URL": "https://opax.vauco.no",
"GITHUB_PAT": "<ditt-token>",
"MCP_SECRET": "<mcp-server-key>"
}
}
}
}
```
## Cloud Run (SSE transport)
Deployes automatisk via `cloudbuild.mcp.yaml` på push til `main`.
Endepunkt: `https://opax-mcp-<hash>-uc.a.run.app`
## Env-vars
| Var | Beskrivelse | Default |
|-----|-------------|--------|
| `OPAX_BASE_URL` | OPAX Cloud Run URL | `https://opax.vauco.no` |
| `MCP_SECRET` | Bearer token (Secret Manager: `mcp-server-key`) | |
| `GITHUB_PAT` | GitHub Personal Access Token | |
| `GH_REPO` | Repo slug | `vauco-saas/OSVauco` |
| `GOOGLE_CLOUD_PROJECT` | GCP project ID | `propane-will-491900-m5` |