Retool MCP

Você pode se conectar ao servidor MCP da Retool diretamente do seu ambiente de codificação. O MCP da Retool permite que você crie apps a partir do seu ambiente de desenvolvimento escolhido, importe apps React para a Retool e gerencie as configurações e usuários da sua organização.

[!-secondary] -secondary nota

O servidor MCP fornece acesso à funcionalidade da Retool em um ambiente externo. Essa funcionalidade é distinta do recurso MCP, que permite conectar ferramentas e serviços de terceiros como uma integração nativa em apps clássicos, fluxos de trabalho e agentes.

Consulte a referência de ferramentas MCP para obter a lista completa de ferramentas.

Recursos

O servidor MCP fornece os seguintes recursos principais:

• A capacidade de gerenciar organizações e usuários usando uma lista de ferramentas predefinidas.
• Autenticação via OAuth 2.0.
• Transporte HTTP transmitível.

Casos de uso

Os seguintes casos de uso são exemplos do que pode ser realizado usando o servidor MCP:

Para obter uma lista completa de ferramentas disponíveis, consulte a referência de ferramentas MCP ou instale o servidor MCP e execute tools/list.

Conectar servidor MCP

Você pode conectar o servidor MCP da Retool a um cliente compatível com MCP usando os seguintes detalhes:

• URL: https://<your-retool-instance>/mcp (por exemplo, https://example.retool.com/mcp)
• Transporte: HTTP
• Autenticação: OAuth 2.0

Depois de autenticar seu servidor MCP com OAuth 2.0, talvez seja necessário reiniciar seu agente de codificação.

Agentes de codificação comuns

Os exemplos a seguir mostram como conectar ao servidor MCP com agentes de codificação comuns.

[!-info] -info Agentes da Retool

Para configurar o servidor MCP como uma ferramenta para uso em Agentes da Retool, conclua as seguintes etapas:

1. Navegue até a aba Recursos na Retool. Clique em Criar novo > Recurso e selecione Servidor MCP.
2. Configure o recurso:
3. Título: Retool MCP 2. Descrição: An MCP server for interacting with Retool. 3. URL do servidor: https://example.retool.com/mcp 4. Clique em Configurar autenticação automaticamente. 5. Role para baixo e clique em Conectar com OAuth.
4. Navegue até um agente novo ou existente e adicione uma nova ferramenta.
5. Clique em Adicionar nova ferramenta. 2. Selecione Conectar ao servidor MCP. 3. No menu suspenso, selecione o servidor MCP que você criou na etapa anterior. 4. Clique em Salvar.
6. Teste seu agente na aba Chat.

[!-info] -info Claude

Para configurar o servidor MCP para Claude Code, conclua as seguintes etapas:

1. No seu terminal, execute o seguinte comando:

claude mcp add --transport http retool https://example.retool.com/mcp

2. Saia da sua sessão do Claude Code e inicie uma nova sessão.
3. Execute /mcp e selecione o servidor MCP retool, que requer autenticação. Uma janela do navegador abre e solicita que você selecione os escopos desejados.
4. Autentique-se e retorne ao Claude Code. O servidor MCP está pronto para uso.

[!-info] -info ChatGPT

[!-secondary] -secondary nota

Você deve ter o Modo desenvolvedor ativado no ChatGPT para adicionar o servidor MCP da Retool.

Para configurar o servidor MCP para ChatGPT, use as seguintes etapas:

1. No ChatGPT, navegue até Configurações > Apps.
2. Na seção Configurações avançadas, clique em Criar app.
3. Insira as seguintes informações:
4. Nome: Retool 2. URL do servidor MCP: https://example.retool.com/mcp 3. Autenticação: OAuth
5. Clique em Criar. Uma janela do navegador abre para consentimento OAuth.
6. Autorize os escopos solicitados e retorne ao ChatGPT.

[!-info] -info Codex

Para configurar o servidor MCP via CLI para Codex, conclua as seguintes etapas:

1. No seu terminal, execute o seguinte comando:

codex mcp add retool --url https://example.retool.com/mcp

2. Uma janela do navegador abre e solicita que você selecione os escopos desejados.
3. Autentique-se e retorne ao Codex. O MCP está pronto para uso.

[!-info] -info Cursor

Para configurar o servidor MCP no Cursor, conclua as seguintes etapas:

1. Abra Configurações > MCP (ou edite .cursor/mcp.json na raiz do seu projeto). Adicione seu servidor MCP da Retool:

{
"mcpServers": {
   "retool": {
      "type": "http",
      "url": "https://example.retool.com/mcp"
   },
   ...outros servidores mcp
}
}

2. Reinicie o Cursor. O fluxo OAuth é acionado automaticamente quando uma ferramenta é invocada pela primeira vez.

[!-info] -info Kiro

Para configurar o servidor MCP para o CLI Kiro, conclua as seguintes etapas:

1. No seu terminal, execute o seguinte comando:

kiro-cli mcp add --name "Retool" --scope global --url "https://example.retool.com/mcp"

2. Saia da sua sessão do CLI Kiro e inicie uma nova sessão.
3. Execute /mcp e selecione o MCP retool, que precisa de autenticação. Clique no link para redirecionar para a autenticação OAuth.
4. Selecione os escopos desejados e clique em Autorizar.
5. Retorne ao CLI Kiro. O MCP está pronto para uso.

Servidor MCP para instâncias auto-hospedadas

O servidor MCP da Retool está disponível para instâncias auto-hospedadas que usam a versão 4.0.0 ou posterior. O servidor MCP tem os mesmos requisitos da nova experiência de criação de apps.

Consulte os tutoriais para configurar a infraestrutura auto-hospedada pela primeira vez, ou os guias de atualização para configurar sua instância para a versão mais recente.