Connect AI agent to Maestro MCP
Overview
This document describes how to connect your AI agent to Equativ's Maestro MCP.
Before you start
You need the following before you start connecting your AI agent to Equativ's Maestro MCP.
- Maestro account: The email and password you use in the Maestro UI.
-
Server URL:
https://maestro.mcp.eqtv.io
The agent uses your Maestro account, with the same user rights as the ones you have in the Maestro UI.
In the Maestro history, the agent's changes appear under your name, with a mention of the agent used.
The following aren't supported to connect:
- Maestro API accounts: API accounts are only authorized to access the Maestro API. Maestro MCP doesn't support login with a client id and secret.
- Autonomous agents and scheduled jobs: A job that runs server to server, with no person behind it, doesn't work. It works only when a person is logged in with their own Maestro account in the AI agent.
- Bearer token: A token copied from the Maestro UI, or requested by hand, doesn't work.
Connect your AI agent
Proceed as follows to connect your AI agent to Maestro MCP:
- Add Maestro MCP in your agent. See the steps for each agent below.
- Your agent opens the Equativ login page in your browser.
- Log in with your Maestro email and password.
- Accept the access request. This allows Maestro MCP to use your Maestro account.

Supported AI agents
Claude.ai and Claude Desktop
The Maestro MCP is available in Claude marketplace:
- Go to Customize > Connectors and search Maestro, or open the Maestro connector directly.
- Click Connect, then log in.
If you don't find it, add it as a custom connector:
- In Customize > Connectors, click + Add, then Add custom connector.
- Enter the name
Maestroand the URLhttps://maestro.mcp.eqtv.io, then click Continue. - Keep the detected settings and click Continue.
- Under OAuth client, keep Use Claude's published identity (Recommended). Click Add, then log in.
Then, in a chat, click +, then Connectors, and turn on Maestro.
On a Team or Enterprise plan, an owner adds the connector once for the organization. For a custom connector, the owner uses Organization settings > Connectors, then Add > Custom > Web. Each user then clicks Connect on Maestro in Customize > Connectors.
Claude Code
To connect with Maestro MCP, proceed as follows:
- Run
claude mcp add --transport http maestro https://maestro.mcp.eqtv.io. - In Claude Code, run
/mcp, selectmaestro, then log in in your browser.

Antigravity
To connect with Maestro MCP, proceed as follows:
- Run
agy mcp add maestro https://maestro.mcp.eqtv.io - In Antigravity, run
/mcp, selectmaestro, then log in in your browser.

Microsoft Copilot Studio
To connect with Maestro MCP, proceed as follows:
- Open your AI agent, go to Tools, click Add a tool, then New tool.
- Click Add, then select Model Context Protocol (MCP).
- Fill Server name, Server description and Server URL (
https://maestro.mcp.eqtv.io). - Under authentication, select OAuth 2.0, then Dynamic (with discovery). Click Add.
- Click Create a new connection, log in, then click Add to agent.

Other agents
The agent can connect to Maestro MCP under these conditions:
- It supports login with CIMD (Client ID Metadata Document).
- Equativ authorized its redirect domain (redirect URI).
- Equativ authorized its CIMD document.
Try to connect it with the steps above. If the login fails, see “Troubleshooting”.
Troubleshooting
Issuer mismatch
The Issuer mismatch error occurs when the agent strictly checks the metadata of the Equativ login server, for example mcp-remote or Codex CLI. Maestro MCP doesn't support these agents yet. In this case, contact Maestro support with the agent name and the error message.
If this error occurs, the agent stops before the login page and returns the error:
IssuerMismatchError: Issuer mismatch in authorization server metadata (RFC 8414 §3.3)Agent not supported
The Agent not supported error occurs when the AI agent uses DCR (Dynamic Client Registration) to authenticate, which is deprecated. In the agent settings, select the more secure CIMD (Client ID Metadata Document) method.
If the agent doesn't support CIMD, contact Maestro support with the name of the agent and the redirect_uri from the URL on the login page.
https://login.eqtv.io/login?response_type=code&client_id=[CLIENT_ID]&redirect_uri=https%3A%2F%2Fexample.com%2Foauth%2Fcallback&state=[STATE]&code_challenge=[CODE_CHALLENGE]&code_challenge_method=S256&scope=openid%20profile%20email%20offline_accessCIMD invalid request
The CIMD error occurs when Equativ hasn't authorized the CIMD document of the agent yet. As shown in the following screenshot, click See details for this error, then send the line that starts with invalid_request to Maestro support. It provides the URL of the CIMD document of your agent, for example:
invalid_request : Unknown client: https://vscode.dev/oauth/client-metadata.json.