# Conecte seu app de IA ao AgenticRelay com MCP

> Adicione o servidor MCP do AgenticRelay ao Claude, ChatGPT, Cursor ou VS Code. Um único login alcança todos os seus workspaces. Sem cobrança, com limites.

Source: https://agenticrelay.app/pt-BR/mcp

Configure o servidor MCP no Claude, ChatGPT, Cursor ou VS Code com uma única URL.

## A URL do servidor

O servidor MCP do AgenticRelay está disponível para todos os workspaces. Informe esta URL ao seu app de IA e nada mais. Ele encontra sozinho os endpoints de login e de token.

```
https://mcp.agenticrelay.app/mcp
```

## Uma conexão, todos os workspaces

Uma conexão pertence à sua conta, não a um workspace. Você conecta uma vez e o app alcança todos os workspaces em que você é membro ativo, com o papel que tem em cada um. Um workspace em que você entrar depois funciona sem reconectar.

Cada ferramenta aceita um workspaceId opcional. Quando sua conta tem vários workspaces, a IA chama list_workspaces para ver os ids e o seu papel em cada um, e depois passa o workspaceId certo. Com um único workspace, ela pode omiti-lo.

O acesso é verificado a cada chamada. Se você sair de um workspace ou perder um papel, o app o perde na chamada seguinte.

## Adicione ao seu app de IA

Use a mesma URL do servidor em todo lugar. Escolha o seu app:

### Claude (claude.ai e Claude Desktop)

1. Abra Settings e depois Connectors.
2. Escolha Add custom connector.
3. Cole a URL do servidor e confirme.
4. Entre no AgenticRelay e permita o acesso quando solicitado.

### Claude Code

Execute este comando no terminal e depois use /mcp dentro do Claude Code para entrar:

```
claude mcp add --transport http agenticrelay https://mcp.agenticrelay.app/mcp
```

### ChatGPT

1. Abra Settings, depois Apps e então Advanced settings.
2. Ative o Developer mode.
3. Escolha Create app, cole a URL do servidor e escolha OAuth.
4. Entre no AgenticRelay e permita o acesso quando solicitado.

### Cursor

O Cursor ainda não consegue se registrar diretamente no servidor, então ele se conecta pela ponte mcp-remote. Adicione isto ao seu mcp.json:

```
{
  "mcpServers": {
    "agenticrelay": {
      "command": "npx",
      "args": [
        "-y",
        "mcp-remote",
        "https://mcp.agenticrelay.app/mcp"
      ]
    }
  }
}
```

### VS Code

Abra a paleta de comandos, execute MCP: Add Server, escolha HTTP e cole a URL do servidor. Ou adicione isto ao seu mcp.json:

```
{
  "servers": {
    "agenticrelay": {
      "type": "http",
      "url": "https://mcp.agenticrelay.app/mcp"
    }
  }
}
```

## O que acontece ao conectar

O seu app de IA se registra sozinho e leva você a uma página de consentimento do AgenticRelay. Entre, se for preciso, e confira o que ele pede. A página mostra os workspaces em que o app poderá atuar, com o seu papel em cada um. Você aprova uma única vez.

O servidor usa OAuth 2.1 com PKCE e registro dinâmico de clientes, então nenhuma chave de API é compartilhada e nada é copiado à mão. O app só faz o que o seu papel permite no workspace de destino de cada chamada.

## Revogue o acesso quando quiser

No AgenticRelay, abra Settings e depois Connected apps, no grupo Account. Desconecte um app e o acesso dele termina em todos os workspaces na chamada seguinte.

## Custo e limites

O uso do servidor MCP não é cobrado. Cobramos o que os seus funcionários de IA consomem, como em qualquer plano.

Cada conexão tem limites antiabuso de cerca de 120 chamadas e 20 gravações a cada 60 segundos. As chamadas MCP contam para o limite, e uma chamada acima dele recebe um 429 com um cabeçalho Retry-After.