Overview
The Opus MCP server lets an AI agent work in your Opus organization through the Model Context Protocol. Once connected, your agent can find, read, edit, and test workflows, map business processes, and manage workspaces and members, using the same permissions you have in the Opus app. The server is split into categories. Each category is a separate MCP server URL with its own set of tools. You add one server entry in your client for each category you need.Access to the Opus MCP server is enabled per organization. If your organization is not enabled yet, contact your Opus account team to request access.
Server URLs
On the Opus cloud, all categories share the base URLhttps://mcp.opus.com. Append /v1/mcp/{category}:
What Agents Can Do
Each category gives the agent a set of capabilities. The agent can use a capability only when your role has the matching workflow, process, or organization permission. See Permissions. Every category also includes a few basic tools, so you never need a separate connection for them. They let the agent see which tools your key can use, read Opus guides, check the result of an earlier call, and list your workspaces. The exact tool list depends on your role and can change between releases. To see the current set, ask your agent to list its Opus tools.Build
Build can read and change workflows.- Find and read workflows, their versions, nodes, and the checks Opus runs on them.
- See who else has a workflow open, and what changes other people and agents plan on it.
- Search the marketplace for agents, code, and human tasks, connect them to a workspace, and list integrations with their credential status. Credential values never come back.
- Create workflows, and add, change, connect, and remove nodes, including prompts, code, variables, routes, and execution settings. People who have the workflow open see each edit live.
- Archive a workflow and restore an archived one. Build never activates or deactivates a workflow. People do that in the Opus app.
- Start test runs of a whole workflow or of single nodes, read their results, and stop them. Each test run spends credits.
Discover
Discover can read and change business processes.- Find and read business processes and their steps, with assignees, approval state, and comments.
- Create draft processes, and add, change, and remove steps. Discover cannot change or remove an approved step.
- Add comments to steps, as new threads or as replies.
- Approve and unapprove steps as you. Only the assignee of an assigned step can approve it. Discover does not approve the process itself.
Admin
Admin can read and change organization settings. It acts on people, so review its use with care.- List organization members, pending invitations, and roles, with the access each role gives.
- Create workspaces and change their name, description, industry, categories, or color. You become the Workspace Admin of a workspace that the agent creates.
- Invite people by email to workspaces, each with a role. Each invited person gets a real invitation email and a notification.
- Change members’ organization roles, their roles in workspaces they already belong to, and their org unit membership and roles, or remove their workspace access. Admin never adds a member to a new workspace: use an invitation for that. This change can remove access.
Authentication
The Opus MCP server uses your Opus API key. It does not support OAuth.1
Create an API key
In the Opus app, open API Keys (
/app/dashboard/api-keys) and create a key. Copy it when it is shown.2
Send it as a header
Your MCP client sends the key on every request, in either header:
- Keys belong to a user. The agent acts as the user who created the key, in that user’s organization.
- Keys belong to a deployment. A key works only on the deployment that issued it. A key used on another deployment’s MCP URL returns
401. - Keep keys out of config files where you can. Where a client supports environment variable references, store the key in an environment variable such as
OPUS_API_KEYand reference it from the config, so the key stays out of the file. Each client guide notes where the key is stored.
Your API key is a unique, secret credential. Store it securely, never commit it to version control, and never expose it in client-side code.
Permissions
The server applies the same role-based access as the Opus app:tools/listreturns only the tools your role allows. A tool you cannot use does not appear in your client.- If an agent calls a tool your role does not allow, the call returns a tool error with
code: "permission_denied"and names the required permission.
Transport
The server speaks MCP over Streamable HTTP and is stateless:- Requests use
POSTonly. With a valid key,GETandDELETEreturn405, so clients that use the older SSE transport cannot connect. Without a valid key, every request returns401first. - A
POSTto/v1/mcpwithout a category returns400with the list of categories.
Connect Your Client
Claude Code
Add Opus with one
claude mcp add command per categoryClaude Desktop
Use a custom connector or a local config file
VS Code
Configure Copilot agent mode with a secure key prompt
Other Clients
Codex, Cursor, Gemini CLI, and any Streamable HTTP client
Troubleshooting
Fix connection, authentication, and permission errors