Promethic

Dirija o Promethic a partir de qualquer script ou agente

Toda conta Promethic inclui uma API pública + uma ferramenta de linha de comando. Leia seus prompts, execute-os com entrada, edite e crie-os. Grátis, incluído em todos os planos.

O que você pode fazer

Leia seus prompts

Liste, busque e inspecione prompts, versões, registros e o catálogo de modelos.

Execute-os com entrada

Transmita respostas de LLM com os mesmos modelos que os aplicativos de desktop e web usam.

Edite e crie

Crie prompts, adicione versões, envie anexos — tudo a partir de um script ou manifesto YAML.

Navegue pelo catálogo

Descubra modelos disponíveis, seus parâmetros e custos por milhão em tempo de execução.

Comece em 60 segundos

1. Entre em app.getpromethic.com.
2. Gere uma chave em Configurações → Chaves de Desenvolvedor. Escolha os escopos desejados (read, execute, write) e copie o segredo — você só o verá uma vez.

3.  npm install -g @soulwarestudio/promethic-cli
   

4.  promethic auth login   # paste your pmk_... key
   

5.  promethic prompts list
    promethic run <prompt-id> --input "resuma este artigo"
   

Or skip the CLI — talk to the API directly with curl:

curl -H "X-API-Key: pmk_..." \
  https://api.getpromethic.com/api/v2/public/prompts

Referência completa em api.getpromethic.com/agent-api-v1.

Conecte agentes diretamente (MCP hospedado)

O Promethic também executa um servidor MCP hospedado, para que Claude Desktop, Cursor, Claude iOS, claude.ai web, ChatGPT (Pro/Enterprise) e Codex CLI possam chamar seus prompts diretamente — sem CLI, sem instalação. Mesma chave pmk_..., todas as 26 ferramentas principais (listar / obter / criar / atualizar prompts, executar / revisar / finalizar execuções de prompts, criar / excluir / corrigir registros, enviar anexos, navegar pelo catálogo de modelos) além de suas ferramentas sintetizadas por prompt.

Claude Desktop

Adicione o Promethic ao claude_desktop_config.json.

Cursor

Mesma estrutura de configuração — coloque-a nas configurações de MCP do Cursor.

Claude iOS

Adicione um conector personalizado no aplicativo — URL mais cabeçalho de autenticação.

claude.ai web

Mesmo fluxo de conector personalizado do iOS, no navegador.

ChatGPT (Pro / Enterprise)

Adicione como conector personalizado via Configurações → Conectores. O plano gratuito ainda não suporta MCP personalizado.

Codex CLI

Adicione ao ~/.codex/config.toml (TOML, não JSON).

Conecte Claude Desktop ou Cursor

Adicione esta entrada ao claude_desktop_config.json (ou à configuração MCP equivalente do Cursor) e reinicie o cliente:

{
  "mcpServers": {
    "promethic": {
      "url": "https://mcp.getpromethic.com/v1",
      "headers": {
        "Authorization": "Bearer pmk_..."
      }
    }
  }
}

Conecte Claude iOS, claude.ai web ou ChatGPT (OAuth)

Esses clientes usam OAuth 2.1 em vez de colar chave de portador. Em Configurações → Conectores (ou equivalente) de cada aplicativo, adicione um novo conector MCP com:

• URL: https://mcp.getpromethic.com/v1
• Auth: deixe URL de Autorização / ID do Cliente em branco — o cliente os descobre automaticamente.

Ao conectar, uma janela pop-up abre para app.getpromethic.com/oauth-authorize. Entre (ou crie uma conta), revise os escopos solicitados, clique em Permitir. A janela fecha e o conector aparece como Conectado. Re-adicionar o mesmo conector posteriormente pula a tela de consentimento automaticamente.

Revogue uma conexão OAuth a qualquer momento em app.getpromethic.com → Configurações → Aplicativos Conectados. A revogação encerra sessões ativas e tokens filhos imediatamente.

Nota de disponibilidade do ChatGPT: Conectores MCP personalizados são um recurso Pro / Enterprise a partir de 2026-05; o plano gratuito do ChatGPT ainda não suporta servidores MCP personalizados. Conectores adicionados via ChatGPT web também aparecem nos aplicativos iOS / Android da mesma conta.

Conecte Codex CLI

Adicione ao ~/.codex/config.toml:

[mcp_servers.promethic]
url = "https://mcp.getpromethic.com/v1"
[mcp_servers.promethic.headers]
Authorization = "Bearer pmk_..."

O servidor fala MCP Streamable HTTP (especificação 2025-03-26) e retorna um token de sessão vinculado à conexão após initialize. Concessões por ferramenta estão disponíveis como endurecimento opcional na mesma tela de Chaves de Desenvolvedor. Referência completa de MCP hospedado em api.getpromethic.com/agent-api-v1.