Conecte Seu Assistente de IA (MCP)

O PlatoForms suporta o Model Context Protocol (MCP). O padrão aberto que permite que assistentes de IA como Claude, Cursor e OpenAI Codex trabalhem diretamente com sua conta PlatoForms. Uma vez conectado, você pode simplesmente pedir ao seu assistente para:

• “O que a última submissão ao meu formulário de entrada disse?”. Ele encontra o formulário, lê as respostas e pode fornecer um link de download de PDF com tempo limitado.
• “Envie esta entrada de teste para o meu formulário de feedback.”
• “Crie um link para o meu formulário de pedido com o e-mail do cliente pré-preenchido.”
• “Crie um formulário de entrada de cliente para uma clínica de fisioterapia.”. A IA constrói um formulário totalmente novo (ou documento PDF) a partir da sua descrição; abra o link que ela retorna e veja o design aparecer.

Seu assistente só recebe o acesso que você concede. Cada ação passa pelas mesmas verificações de permissão e plano que o aplicativo PlatoForms, e equipes em modo HIPAA não são conectáveis a menos que um proprietário da equipe habilite explicitamente o acesso do assistente de IA.

O endereço do servidor MCP do PlatoForms é:

https://mcp.platoforms.com

Conectar Claude (um clique)

Funciona com Claude na web e Claude Desktop.

1. No Claude, abra Configurações > Conectores e clique em Adicionar conector personalizado.

2. Insira https://mcp.platoforms.com como a URL do servidor e confirme.

3. Claude abre uma página de login do PlatoForms. Faça login e clique em Permitir.

4. Pronto. Pergunte ao Claude algo como “Liste meus formulários do PlatoForms.”

Você pode se desconectar a qualquer momento nas configurações de conector do Claude.

Conectar Claude Code

Em um terminal, execute:

claude mcp add --transport http platoforms https://mcp.platoforms.com

Em seguida, inicie uma nova sessão do Claude Code, digite /mcp, selecione platoforms e escolha Autenticar. Faça login no PlatoForms na janela do navegador que se abre e clique em Permitir.

Para experimentar, pergunte algo como “Usando as ferramentas do PlatoForms, quem sou eu logado como?”. Claude deve responder com seu e-mail de conta e nome da equipe.

Conectar OpenAI Codex

As versões atuais do OpenAI Codex suportam login OAuth para servidores MCP remotos. O PlatoForms usa um cliente OAuth público com PKCE, então sua senha e chave de API nunca são compartilhadas com o Codex.

1. Adicione uma porta de callback OAuth fixa no topo de ~/.codex/config.toml (fora de qualquer seção [mcp_servers.*]):

mcp_oauth_callback_port = 8765

2. Adicione o PlatoForms como um servidor MCP:

codex mcp add platoforms \
  --url https://mcp.platoforms.com \
  --oauth-client-id platoforms-mcp \
  --oauth-resource https://mcp.platoforms.com

3. Inicie o login OAuth:

codex mcp login platoforms --scopes read,write

4. O Codex abre uma página de login do PlatoForms. Faça login e clique em Permitir.

5. Inicie uma nova sessão do Codex e pergunte “Usando as ferramentas do PlatoForms, quem sou eu logado como?”

Você pode desconectar a conta com codex mcp logout platoforms.

Conectar com uma chave de API (alternativa)

OAuth é recomendado para Claude e OpenAI Codex. Cursor, scripts, clientes mais antigos e outras ferramentas compatíveis com MCP podem se conectar com uma chave de API do PlatoForms. No PlatoForms, abra Conta > API e copie seu token de API, depois siga os passos para sua ferramenta abaixo.

Cursor

Adicione o servidor a ~/.cursor/mcp.json (crie o arquivo se ele não existir):

{
  "mcpServers": {
    "platoforms": {
      "url": "https://mcp.platoforms.com",
      "headers": {
        "Authorization": "Bearer <sua chave de API>"
      }
    }
  }
}

Reinicie o Cursor (ou recarregue seus servidores MCP) e peça para listar seus formulários do PlatoForms.

OpenAI Codex (chave de API)

Use este método para automação ou quando o OAuth baseado em navegador não estiver disponível. Se você já configurou a conexão OAuth acima, remova-a primeiro com codex mcp remove platoforms.

Adicione o servidor a ~/.codex/config.toml (crie o arquivo se ele não existir):

[mcp_servers.platoforms]
url = "https://mcp.platoforms.com"
bearer_token_env_var = "PLATOFORMS_API_KEY"

O Codex lê a chave de API da variável de ambiente nomeada por bearer_token_env_var, então torne-a disponível antes de iniciar o Codex. Por exemplo, adicionando esta linha ao seu perfil de shell:

export PLATOFORMS_API_KEY="<sua chave de API>"

Reinicie o Codex e peça para listar seus formulários do PlatoForms.

Outras ferramentas MCP

Qualquer ferramenta compatível com MCP que suporte servidores remotos (Streamable HTTP) pode se conectar. Use https://mcp.platoforms.com como a URL do servidor. Se a ferramenta suportar o OAuth do PlatoForms, use seu fluxo de login no navegador. Caso contrário, envie sua chave de API como um cabeçalho de autorização Bearer.

Ativar ou desativar o acesso do assistente de IA

Os proprietários de equipe podem ativar ou desativar o acesso do assistente de IA para toda a equipe.

1. No PlatoForms, abra Conta > API.

2. Encontre o painel Acesso do Assistente de IA (MCP) e clique em Ativar ou Desativar.

O que seu assistente pode fazer

• Ler. listar e pesquisar formulários, ler definições de campos de formulário, listar e ler submissões, criar links de download expirantes para PDFs gerados e anexos.
• Escrever. enviar entradas de formulário e criar links de convite pré-preenchidos. Apenas links: assistentes nunca podem enviar e-mails da sua conta.
• Criar. novos formulários web e documentos PDF projetados por IA a partir de uma descrição.

Limites de taxa se aplicam além da cota de API do seu plano, e cada convite criado por assistente permanece visível na sua lista de convites para revisão.

Relacionados

• Documentação do Codex MCP da OpenAI
• API e Webhooks
• Política de retenção de dados
• Converse com nossa equipe de suporte