Conecte suas IAs ao BetterPrompt com MCP

Copiar e usar em qualquer IA

No aprimorador ou em um prompt da biblioteca, abra Continue na sua IA. Escolha ChatGPT, Claude, Grok, Gemini, Kimi, GLM · Z.ai, DeepSeek ou outra opção. Clique em Copiar para a IA e depois em Abrir. Cole na conversa, revise e envie. O texto não vai em parâmetros de URL. As plataformas podem exigir login e ter limites próprios. Esse caminho funciona sem configurar MCP.

O que o MCP faz

O MCP permite que um cliente de IA use ferramentas do BetterPrompt. A conexão pública lê somente conteúdo público: search procura na biblioteca pública, fetch lê um prompt publicado, personalize_prompt preenche marcadores exatos, como [curso], e build_tcrei_prompt monta um novo pedido sem executar a tarefa. find_linked_prompts mostra os prompts publicados e verificados que combinam com um prompt ou com um texto que você ainda não publicou, e preview_prompt_merge monta a cópia combinada de até três prompts só para conferência, com variáveis unificadas e conflitos destacados. O servidor também oferece o modelo tcrei e o recurso betterprompt://guide. Nenhum prompt é salvo ou publicado. A conexão personalizada acrescenta get_my_context, que lê apenas os campos autorizados para aquela IA; build_tcrei_prompt e personalize_prompt usam esses valores quando você não fornece outros. Com a permissão de leitura das bibliotecas ligada, a conexão também ganha list_my_libraries e search_my_library: elas devolvem os prompts que você salvou nas suas coleções, inclusive os rascunhos, e fetch passa a abrir um rascunho do próprio dono. Desligada, essas ferramentas nem existem e o rascunho continua inacessível. A permissão de mesclagem é outro opt-in: ligada, a conexão ganha save_prompt_merge, que guarda na sua conta a lista ordenada de ids da mesclagem — nunca valores de variáveis nem o seu contexto; desligada, ela nem existe e a IA só pré-visualiza. Nenhuma conexão lê bibliotecas de outras pessoas, PDFs locais ou a busca web do aprimorador. O contexto autorizado fica armazenado para a conexão por até 30 dias.

Conecte com seu contexto

Escolha Personalizada no seletor acima e copie https://betterprompt.fun/api/mcp/account. No cliente, selecione OAuth e inicie a conexão. Entre na sua conta BetterPrompt, confira o endereço de retorno e escolha os campos que deseja compartilhar. Preencher com meu contexto deste navegador traz os valores locais e seu nome para revisão; desmarque o que não quiser enviar. A mesma tela tem a permissão Ler os prompts das minhas bibliotecas, desligada por padrão: ligada, a IA passa a usar os prompts que você salvou, inclusive rascunhos; desligada, ela continua lendo só a biblioteca pública. Logo abaixo, Gravar as minhas mesclagens de prompts libera a IA de salvar a lista ordenada de prompts que você escolher copiar junto, sem nunca publicar nada. Clique em Autorizar e retorne à IA. É possível autorizar sem dados pessoais. Esta opção exige um cliente com suporte a OAuth para MCP.

Edite ou revogue no perfil

Em Meu perfil → Suas IAs conectadas, abra uma conexão, altere os campos, ajuste as permissões Ler os prompts das minhas bibliotecas e Gravar as minhas mesclagens de prompts e salve. As próximas chamadas recebem os novos valores. Revogar acesso bloqueia novas consultas imediatamente, mas não apaga informações já recebidas pela IA ou presentes em conversas anteriores. Mudanças no contexto local do navegador não atualizam conexões automaticamente. Após 30 dias, faça uma nova autorização. A alternativa Pública usa https://betterprompt.fun/api/mcp sem autenticação e não recebe seu perfil; os exemplos de configuração abaixo usam essa alternativa.

Clientes de código (CLI)

Estes clientes aceitam servidores MCP por arquivo de configuração, sem tela de conector. No Gemini CLI, acrescente a entrada ao objeto mcpServers da sua configuração, preservando os outros servidores, reinicie o cliente e confira as ferramentas com /mcp. No Kimi Code CLI, abra /mcp-config para adicionar um servidor HTTP ou acrescente a entrada ao objeto mcpServers em ~/.kimi-code/mcp.json e confira a conexão em /mcp numa nova sessão. Para usar GLM · Z.ai ou DeepSeek, configure esse provedor no Cline — as credenciais ficam no cliente, nunca no BetterPrompt — e adicione o BetterPrompt em MCP Servers → Remote Servers com transporte Streamable HTTP. Os exemplos abaixo usam a conexão pública, sem autenticação; num cliente com suporte a OAuth, o endereço /api/mcp/account abre a conexão personalizada com os campos que você autorizar. Nenhum desses caminhos adiciona um conector ao chat web dessas plataformas: nesses chats, use Copiar e abrir.

Gemini CLI
{
  "mcpServers": {
    "betterprompt": {
      "httpUrl": "https://betterprompt.fun/api/mcp",
      "trust": false
    }
  }
}

Kimi Code CLI
{
  "mcpServers": {
    "betterprompt": {
      "url": "https://betterprompt.fun/api/mcp"
    }
  }
}

Cline
{
  "mcpServers": {
    "betterprompt": {
      "type": "streamableHttp",
      "url": "https://betterprompt.fun/api/mcp",
      "disabled": false,
      "autoApprove": []
    }
  }
}

Teste a primeira conversa

Na conexão personalizada, peça primeiro: use get_my_context e me diga quais campos autorizei. Depois peça explicitamente a ferramenta para confirmar que a IA está usando o BetterPrompt. Uma busca pode retornar uma lista vazia quando não existir um prompt público para o termo. A criação TCREI funciona mesmo com a biblioteca vazia.

Use BetterPrompt.search com query "estudos". Leia um resultado com fetch. Depois use build_tcrei_prompt para montar um plano de estudos de matemática para [curso], nível iniciante, 30 minutos por dia. Não publique nada.

Se a conexão não funcionar

Copie a URL completa, incluindo /api/mcp, e escolha Streamable HTTP, não SSE legado. Abrir essa URL numa aba comum pode mostrar 405: ela recebe mensagens MCP por POST. Use Testar servidor nesta página para conferir a disponibilidade. Se as ferramentas não aparecerem, atualize o conector e confirme as permissões da conta. Em resposta 429, aguarde um minuto. A URL /api/mcp não exige autenticação. A URL /api/mcp/account retorna 401 até a autorização OAuth: isso não significa que o servidor está fora do ar. Se a solicitação expirar, reinicie pela IA. Nunca cole sua senha BetterPrompt em um campo de token. O funcionamento do protocolo é testado com o cliente oficial MCP; disponibilidade e aprovação dentro de cada plataforma dependem da conta e do aplicativo.