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: 

  1. Add Maestro MCP in your agent. See the steps for each agent below.
  2. Your agent opens the Equativ login page in your browser.
  3. Log in with your Maestro email and password.
  4. 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:

  1. Go to Customize > Connectors and search Maestro, or open the Maestro connector directly.
  2. Click Connect, then log in.

If you don't find it, add it as a custom connector:

  1. In Customize > Connectors, click + Add, then Add custom connector.
  2. Enter the name Maestro and the URL https://maestro.mcp.eqtv.io, then click Continue.
  3. Keep the detected settings and click Continue.
  4. 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: 

  1. Run claude mcp add --transport http maestro https://maestro.mcp.eqtv.io.
  2. In Claude Code, run /mcp, select maestro, then log in in your browser.


Antigravity

To connect with Maestro MCP, proceed as follows:

  1. Run agy mcp add maestro https://maestro.mcp.eqtv.io
  2. In Antigravity, run /mcp, select maestro, then log in in your browser.


Microsoft Copilot Studio

To connect with Maestro MCP, proceed as follows:

  1. Open your AI agent, go to Tools, click Add a tool, then New tool.
  2. Click Add, then select Model Context Protocol (MCP).
  3. Fill Server name, Server description and Server URL (https://maestro.mcp.eqtv.io).
  4. Under authentication, select OAuth 2.0, then Dynamic (with discovery). Click Add.
  5. 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_access

CIMD 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.