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 ChatGPT, 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 do meu formulário de inscrição disse?”. ele encontra o formulário, lê as respostas e pode fornecer um link para 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 inscrição para evento para nosso workshop comunitário.”. a IA constrói um formulário completamente novo (ou documento PDF) a partir da sua descrição; abra o link que ele retorna e veja o design aparecer.

Para usar o MCP, você precisa de uma conta PlatoForms com acesso à API. Novas contas incluem acesso à API durante o teste gratuito de 15 dias. As ações do assistente usam sua cota de API disponível e estão sujeitas a limites de taxa adicionais.

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. Para equipes com conformidade HIPAA habilitada, o acesso do assistente de IA está desativado por padrão. um proprietário da equipe pode ativá-lo após revisar a seção uso de dados e dados restritos abaixo.

O endereço do servidor MCP do PlatoForms é:

https://mcp.platoforms.com

Conectar ChatGPT

1. Abra Plugins no ChatGPT e procure por PlatoForms, ou abra a página do plugin PlatoForms.

2. Selecione Instalar, depois faça login no PlatoForms.

3. Escolha acesso somente leitura ou leitura e escrita e selecione Permitir.

4. Em um chat, digite @PlatoForms e pergunte algo como “Liste meus formulários publicados e suas contagens de submissão.”

Sua senha do PlatoForms não é compartilhada com o ChatGPT. Você pode revogar a conexão a qualquer momento.

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 o 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 desconectar a qualquer momento nas configurações de conectores 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 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 da conta e nome da equipe.

Conectar OpenAI Codex

As versões atuais do OpenAI Codex suportam login OAuth para servidores MCP remotos. O PlatoForms suporta descoberta OAuth, registro dinâmico de cliente e PKCE, então sua senha e chave da API nunca são compartilhadas com o Codex.

1. Adicione o PlatoForms como um servidor MCP:

codex mcp add platoforms --url https://mcp.platoforms.com

2. Inicie o login OAuth:

codex mcp login platoforms

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

4. 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 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 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 (HTTP Streamable) pode se conectar. Use https://mcp.platoforms.com como o URL do servidor. Se a ferramenta suportar 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 da 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 ao Assistente de IA (MCP) e clique em Ativar ou Desativar.

Para equipes sem conformidade HIPAA habilitada, o acesso do assistente de IA está ativado por padrão. Para equipes com conformidade HIPAA habilitada, está desativado por padrão e permanece desativado até que um proprietário da equipe o ative. Você não precisa desativar o modo HIPAA para usar o MCP.

Solução de problemas

Erro 462

A cota de API do seu plano foi atingida. Ou atualize seu plano ou aguarde até que seu próximo ciclo de faturamento redefina a cota.

Erro 403. Permissão negada

Este erro aparece em duas situações diferentes:

• Problema real de permissão. a conta conectada não tem acesso ao recurso solicitado (por exemplo, um formulário pertencente a uma equipe diferente).
• Recurso não encontrado. o ID do formulário ou ID de submissão passado para a ferramenta não existe. Verifique o ID e tente novamente.

Se você estiver confiante de que o ID está correto e a conta tem acesso, tente desconectar e reconectar para garantir que a sessão OAuth esteja atual.

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 em sua lista de convites para revisão.

Para exemplos de prompts para cada um desses, o que retorna, e as coisas que seu assistente não pode fazer, veja O que perguntar ao seu assistente de IA.

Uso de dados e dados restritos

O PlatoForms envia ao assistente conectado apenas a entrada da ferramenta e o resultado necessários para a ação que você solicita. Dependendo da ferramenta, isso pode incluir sua identidade de conta, nomes de formulários e definições de campos, dados de submissão, metadados de documentos gerados e links de arquivos com tempo limitado. O serviço MCP é um retransmissor sem estado para a API do PlatoForms e não mantém uma cópia separada do conteúdo do formulário ou submissão após a conclusão de uma solicitação. Ele não recebe seu histórico completo de chat de IA.

O provedor de IA que você conecta recebe as entradas e resultados da ferramenta e os processa sob seus próprios termos, política de privacidade, regras de retenção e configurações de conta. Revise essas políticas antes de conectar:

• Política de Privacidade do PlatoForms
• Termos de Serviço do PlatoForms
• Contate o suporte do PlatoForms

Não use a integração MCP para coletar, enviar ou processar dados de cartão de pagamento sujeitos ao PCI DSS, identificadores governamentais, senhas, chaves de API, segredos de autenticação ou códigos MFA/únicos.

Informações de saúde protegidas (PHI). O MCP está desativado por padrão para equipes com conformidade HIPAA habilitada, e um proprietário da equipe pode ativá-lo. Os dados enviados a um provedor de IA de terceiros através do MCP não estão cobertos pelo Acordo de Associação de Negócios do PlatoForms. Se você ativar o MCP em uma equipe habilitada para HIPAA, é sua responsabilidade como entidade coberta determinar se a divulgação é permitida sob as Regras HIPAA e manter qualquer acordo que você exija diretamente com o provedor de IA que você conecta.

O plugin público do PlatoForms para ChatGPT não deve ser usado para coletar, enviar, recuperar ou processar PHI de qualquer outra forma.

Relacionados

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