Coding agents

Coding agents like Claude Code, Codex and opencode can deploy your apps and look after them through Alf's MCP server: create services, deploy, read logs and metrics, roll back, try changes in previews.

The agent opens your browser; you approve it and choose the organization, whether it may only look or also deploy, and which projects.

With the command line installed, alf agents finds Claude Code, Codex and Cursor on your machine and adds the server to each, asking first. By hand:

Claude Code

claude mcp add --transport http alf https://api.runalf.com/mcp

Then run /mcp in Claude Code, pick alf and Authenticate.

Codex

codex mcp add alf --url https://api.runalf.com/mcp
codex mcp login alf

opencode: in opencode.json:

{
  "$schema": "https://opencode.ai/config.json",
  "mcp": { "alf": { "type": "remote", "url": "https://api.runalf.com/mcp", "enabled": true } }
}

then opencode mcp auth alf.

Other MCP clients (Cursor, VS Code, Windsurf, …): add a remote (HTTP) MCP server with the address https://api.runalf.com/mcp.

Every agent with access, signed in or with a token, is listed under Agents → Connected agents, where you can disconnect it.

Connect with a token

For CI, scripts or clients without sign-in: make a token under Agents (choose read or read & deploy, optionally one project, an expiry and limits) and send it as Authorization: Bearer sat_…. The Agents page shows the exact setup for each client.

Tell the agent how you work

Add a few lines to your repository's AGENTS.md or CLAUDE.md, for example:

## Deploying
This app runs on Alf; use its MCP tools (server "alf").
- After pushing, deploy the service that changed and wait_for_deployment until it's live or failed.
- Passwords and keys go in secrets, never in variables or the repository.
- Don't delete anything unless I ask for exactly that; take a snapshot of a volume before changing its data.

What the agent sees

Besides the tools, agents can read a guide and a summary of each project (services, addresses, how they connect) and use ready-made prompts: deploy, debug_deployment and preview_changes (slash commands in Claude Code). Agents without MCP can read llms.txt.

What the agent did

Agents → What agents did lists every change agents made in the last 30 days, and notifications can tell you as it happens.