Servidor MCP do FluoTest
O FluoTest tem um servidor MCP (Model Context Protocol) remoto, para que assistentes de IA como o Claude e o ChatGPT gerenciem os quizzes da sua conta: listá-los, criá-los e editá-los (incluindo pontuação, resultados e configurações), publicá-los, ler os resultados e excluí-los quando você pedir, sempre pelo nome, nunca caçando um UUID. As conexões são autorizadas com OAuth (você aprova o acesso em uma tela de consentimento) ou com uma chave de API pessoal gerada nas Configurações.
Última atualização
Como conecto um assistente de IA ao FluoTest?
No ChatGPT, adicione o plugin do FluoTest pelo diretório de plugins do ChatGPT e entre na sua conta. No Claude, o jeito mais rápido é o diretório de conectores do Claude (claude.ai/directory/fluotest): clique em Add e entre na sua conta. Em qualquer outro cliente MCP, adicione https://fluotest.com/api/mcp manualmente como servidor MCP remoto: com OAuth, você entra no FluoTest e aprova o acesso em uma tela de consentimento, ou gera uma chave de API em Configurações → Segurança → Chaves de API e a envia como token Bearer.
URL do servidor#
O servidor MCP fica em uma única URL:
https://fluotest.com/api/mcp
Ele usa o transporte Streamable HTTP. Toda requisição precisa ser autenticada; requisições sem autenticação recebem uma resposta 401 que indica aos clientes MCP onde iniciar o fluxo OAuth.
Autenticação#
Há duas formas de autenticação. As duas agem como a sua conta de usuário: o assistente só pode ver e criar o que você pode.
- OAuth 2.1 (recomendado): Compatível com os conectores personalizados do Claude e outros clientes MCP com suporte a OAuth. Você entra no FluoTest pelo navegador e aprova o acesso em uma tela de consentimento, sem chaves para copiar, e continua no controle do que está conectado.
- Chave de API: Para clientes MCP que aceitam cabeçalhos personalizados (como o Claude Code) ou para seus próprios scripts. Gere uma chave em Configurações → Segurança → Chaves de API e envie-a como "Authorization: Bearer fluo_…". Trate-a como uma senha.
Referência completa da API: chaves, cabeçalhos e exemplos com curl →
Conectar o ChatGPT#
O mais fácil: o plugin do FluoTest para o ChatGPT
O FluoTest está listado no diretório de plugins do ChatGPT. Abra a página do plugin, adicione-o e entre no FluoTest para aprovar o acesso: FluoTest no diretório de plugins do ChatGPT
Depois de adicionado, o ChatGPT usa as mesmas ferramentas listadas em Ferramentas disponíveis: ele pode listar, criar, editar e publicar seus quizzes, ler os resultados e excluir um quiz quando você pedir. Publicar é sempre uma etapa separada, e editar ou excluir um quiz no ar precisa da sua confirmação antes. Para outros clientes MCP, siga os passos do Claude ou da chave de API abaixo.
Conectar o Claude (OAuth)#
O mais fácil: o diretório de conectores do Claude
O FluoTest está listado no Connectors Directory do Claude como conector da comunidade, então não há URL nem campo para preencher. Abra a página do conector e clique em Add: claude.ai/directory/fluotest
Prefere adicionar manualmente ou ainda não vê o conector na lista? No Claude, vá em Settings → Connectors → Add custom connector e preencha:
- Name: FluoTest
- Remote MCP server URL: https://fluotest.com/api/mcp
- Clique em Add e depois em Connect. Você será levado ao fluotest.com para entrar e aprovar o acesso.
Não há client ID nem secret para copiar: o conector se registra automaticamente como cliente OAuth público (PKCE, sem secret) na primeira vez que você conecta.
Conectar com uma chave de API#
Para clientes em que o fluxo OAuth não está disponível:
- No FluoTest, abra Configurações → Segurança → Chaves de API.
- Digite um nome (por exemplo, "Claude Code") e clique em Gerar chave.
- Copie a chave fluo_… imediatamente, porque ela só é exibida uma vez.
- Adicione-a ao seu cliente MCP como cabeçalho Authorization.
Configuração MCP genérica (para clientes no estilo mcp.json):
{
"mcpServers": {
"fluotest": {
"type": "http",
"url": "https://fluotest.com/api/mcp",
"headers": {
"Authorization": "Bearer fluo_YOUR_API_KEY"
}
}
}
}Claude Code (CLI)
claude mcp add --transport http fluotest https://fluotest.com/api/mcp \ --header "Authorization: Bearer fluo_YOUR_API_KEY"
Referência completa da API: chaves, cabeçalhos e exemplos com curl →
Ferramentas disponíveis#
O servidor oferece onze ferramentas que cobrem todo o ciclo de vida de um quiz, da criação de uma avaliação com pontuação à leitura dos resultados. Toda ferramenta aceita um quiz pelo título, slug ou ID, então um assistente nunca precisa que você cole um UUID. Quizzes compartilhados com você em um workspace de equipe também funcionam, com os mesmos direitos de visualização ou edição que você tem no painel.
Algumas configurações dependem do plano do dono do workspace, igual no painel: o e-mail de lembrete para quizzes não concluídos (abandoned_email_*, desativado por padrão) exige o Business, e as prévias de link personalizadas (og_title, og_description) exigem o Pro. Todo o resto, incluindo categorias de pontuação, resultados, o formulário de contato e o e-mail de resultados, funciona em todos os planos.
- list_quizzes: Lista os quizzes que você pode ver: os seus e os dos workspaces de equipe de que você faz parte, com título, ID, slug, status de rascunho ou publicado, número de respostas, data de criação, workspace e se você pode editá-lo. Um assistente chama esta ferramenta primeiro para encontrar um quiz que você menciona pelo nome.
- create_quiz: Cria um quiz em rascunho em uma única chamada, incluindo uma avaliação completa com pontuação: seções, todos os tipos de pergunta com texto de ajuda, categorias de pontuação com suas próprias faixas, seções que pontuam em uma categoria ou não pontuam, regras de exibição condicional e de salto, resultados que apontam para respostas pelo rótulo e configurações do quiz como o formulário de contato antes do resultado, uma tela de resultado só de confirmação, o e-mail de resultados, idioma, textos e tema. Retorna os IDs da nova seção, das perguntas e das opções, além de avisos, por exemplo uma faixa que ninguém consegue atingir. O quiz continua não publicado até você publicá-lo.
- get_quiz_questions: Retorna a estrutura completa e a pontuação de um quiz com os mesmos nomes de campo que o create_quiz usa: seções, perguntas com texto de ajuda, opções com seus pontos por categoria, regras de exibição condicional e de salto, categorias e faixas de pontuação, cada resultado com suas regras e ações e os avisos do Mapa de pontuação. Os assistentes a usam para conferir o trabalho e obter IDs para edições.
- get_quiz_settings: Retorna todas as configurações de um quiz: link público, páginas de boas-vindas e de agradecimento, o que os respondentes veem depois de enviar, o formulário de contato, o e-mail de resultados e de onde vem o endereço dele, notificações para o dono, agendamento e outras opções, idioma e textos personalizados, tema e as integrações ativadas no quiz com seu gatilho, mapeamento de campos e última entrega. As integrações são somente leitura e nunca incluem URLs ou chaves.
- update_quiz: Edita um quiz: qualquer campo que o create_quiz aceita, mais o slug. As perguntas podem ser substituídas ou editadas no lugar com operações que adicionam, editam, movem ou excluem perguntas e seções e mantêm seus IDs, para que as regras de resultado e as respostas antigas continuem vinculadas. Uma substituição completa que perderia regras, textos de ajuda ou pontuações por categoria pede confirmação antes e, se qualquer parte de uma edição falhar, o quiz fica como estava. Editar um quiz publicado exige confirm_edit_published: true; a primeira tentativa não muda nada e mostra o número de respostas e uma lista de antes e depois do que mudaria.
- publish_quiz: Publica um quiz em rascunho, deixando-o no ar na URL pública, só quando você pede. Respeita a aprovação de publicação do seu workspace e retorna avisos sobre configurações que não vão funcionar como esperado, como um e-mail de resultados sem endereço para onde enviar.
- unpublish_quiz: Tira um quiz publicado do ar. As respostas dele são mantidas e ele pode ser publicado de novo depois.
- import_quiz: Cria um rascunho a partir de um documento de quiz do FluoTest: os mesmos campos que o create_quiz aceita, mais schema_version 1, com identificadores ref para os quais as regras de exibição condicional, de salto e de resultado apontam. O documento é verificado primeiro e nada é salvo se houver erros, cada um indicando a pergunta. Campos desconhecidos voltam como avisos, configurações exclusivas do Pro que você não pode usar são ignoradas com um aviso, e tudo o que o quiz de origem tinha e o formato não consegue levar é listado em not_in_file.
- duplicate_quiz: Copia um dos seus quizzes como um novo rascunho, com perguntas, pontuação, resultados, configurações e integrações, para que um assistente possa criar uma variante sem mexer no original.
- get_results: Retorna o número de respostas, a pontuação média, a menor e a maior, a contagem por faixa, médias e faixas por categoria de pontuação, a contagem por resultado e as visualizações e a taxa de conclusão. No Pro, adiciona distribuições de respostas, NPS, abandono por pergunta e tempo médio. Também pode listar as respostas da mais recente para a mais antiga, filtradas por data, pontuação, resultado ou contato, com as pontuações, o resultado e as respostas de cada pessoa. Nomes, e-mails e telefones só são incluídos quando você pede os dados de contato.
- delete_quiz: Exclui permanentemente um dos seus quizzes e as respostas dele. A primeira chamada nunca exclui nada: ela retorna o título e o número de respostas para você confirmar, e uma segunda chamada com confirm: true faz a exclusão.
Exemplo de argumentos do create_quiz: uma avaliação com pontuação
{
"title": "Team health check",
"score_categories": [
{ "label": "Leadership", "tiers": [{ "label": "Needs work", "min": 0, "max": 49 }, { "label": "Strong", "min": 50, "max": 100 }] },
{ "label": "Culture", "tiers": [{ "label": "Needs work", "min": 0, "max": 49 }, { "label": "Strong", "min": 50, "max": 100 }] }
],
"sections": [
{
"title": "About you",
"scored": false,
"questions": [
{ "text": "Your name", "type": "name" },
{ "text": "Team size", "type": "multiple_choice", "options": [{ "label": "1-10" }, { "label": "11+" }] }
]
},
{
"title": "Leadership",
"category": "leadership",
"questions": [
{
"text": "Leaders give regular feedback",
"description": "Think about the last three months.",
"type": "multiple_choice",
"options": [
{ "label": "Rarely", "score": 0 },
{ "label": "Sometimes", "score": 1 },
{ "label": "Always", "score": 2 }
]
}
]
},
{
"title": "Culture",
"category": "culture",
"questions": [{ "text": "People speak up in meetings", "type": "yes_no", "points": 2 }]
}
],
"contact_gate": { "contact_type": "email", "required": true, "name_required": true, "block_disposable_emails": true },
"results_display": "confirmation",
"send_results_email": true,
"results_email_attach_pdf": true,
"hidden_fields": ["website"],
"capture_utm": true
}Cartões no chat#
Em assistentes compatíveis com MCP Apps, como o Claude e o ChatGPT, list_quizzes, get_results, create_quiz, import_quiz, update_quiz, publish_quiz, unpublish_quiz e duplicate_quiz mostram um cartão abaixo da resposta: cartões de quiz com status, número de respostas, número de perguntas e botões para abrir o quiz no editor ou a página pública, ou um cartão de resultados com respostas, pontuação média, taxa de conclusão, faixas de pontuação ou resultados finais e as respostas mais recentes. Outros clientes MCP continuam recebendo os mesmos resultados em texto.
Cada uma dessas ferramentas traz _meta.ui.resourceUri (e o alias do ChatGPT openai/outputTemplate), que aponta para um recurso ui://fluotest/ servido como text/html;profile=mcp-app. O cartão mostra o structuredContent da ferramenta, os mesmos dados do resultado em texto, com o seu idioma do FluoTest no campo locale. É um HTML independente que não carrega nada da rede, e os dados de contato dos respondentes só aparecem quando você os pede (include_contacts).
Cartões no chat
Conectou antes de os cartões existirem? Reconecte o FluoTest ou atualize-o nas configurações de conectores ou apps do seu assistente, para que ele carregue os novos metadados das ferramentas.
Referência de endpoints OAuth#
Os clientes MCP descobrem esses endpoints automaticamente a partir da resposta 401 do servidor e do documento de descoberta; você só precisa deles se um cliente pedir os endpoints explicitamente. Tente primeiro a URL de descoberta OIDC; ela resolve o resto.
| Endpoint | URL |
|---|---|
| Descoberta OIDC | https://abvrtonacdgcxpkkrpie.supabase.co/auth/v1/.well-known/openid-configuration |
| Autorização | https://abvrtonacdgcxpkkrpie.supabase.co/auth/v1/oauth/authorize |
| Token | https://abvrtonacdgcxpkkrpie.supabase.co/auth/v1/oauth/token |
| JWKS | https://abvrtonacdgcxpkkrpie.supabase.co/auth/v1/.well-known/jwks.json |
Perguntas frequentes#
Quais quizzes um assistente conectado pode ver?
Só os seus. Toda chamada de ferramenta roda como a sua conta de usuário, com as mesmas regras de permissão do app, então um assistente não consegue ler quizzes ou resultados de outros usuários.
Como revogo o acesso?
Chaves de API: revogue-as em Configurações → Segurança → Chaves de API, e a chave para de funcionar imediatamente. OAuth: remova o conector no seu assistente de IA; os tokens armazenados são descartados e nenhum novo é emitido sem passar de novo pelo consentimento.
Ele pode publicar quizzes?
Só quando você pede explicitamente. O create_quiz sempre cria um rascunho não publicado, e o publish_quiz, uma ferramenta separada, é a etapa deliberada que coloca o quiz no ar. Nada é publicado automaticamente.
Ele pode editar ou excluir um quiz que já está no ar?
As duas coisas, mas nunca na primeira chamada. A primeira tentativa do update_quiz em um quiz publicado é recusada e mostra o número de respostas e uma lista de antes e depois do que mudaria, sem mudar nada; só uma segunda chamada com confirm_edit_published: true aplica a edição, e substituir perguntas em um quiz no ar também volta com um aviso de que respostas antigas podem fazer referência a perguntas que não existem mais. O delete_quiz funciona do mesmo jeito: primeiro mostra o título do quiz e o número de respostas e só exclui depois que você confirma.
O servidor MCP é gratuito?
Sim, ele está disponível em todos os planos, inclusive nas contas gratuitas.