Três novas maneiras de chamar o Prism — CLI, MCP e SDKs

Durante a maior parte da v1.x, a única maneira de operar o Prism — alterar configurações de cache, definir política de roteamento, limitar um orçamento, auditar quem fez o quê — era através do painel da web. Isso era aceitável quando o produto era um endpoint de chat compatível com OpenAI, além de um pequeno site de marketing. Parou de ser aceitável no momento em que pedimos aos clientes que usassem o Prism em produção.

A v1.8 fecha essa lacuna. Três novas superfícies, todas apoiadas pela mesma API subjacente:

• prism CLI — pip install ssimplifi-cli, 19 comandos, cada ação operacional do painel pode ser scriptada.
• prism-mcp server — npm install -g ssimplifi-prism-mcp, roda no Claude Desktop / Cursor / Zed / Continue / Cline, expõe as ferramentas do Prism para qualquer IA que esteja rodando lá.
• Python + Node SDKs — pip install ssimplifi / npm install ssimplifi-prism, substituições diretas para o SDK do OpenAI em cada linguagem, com kwargs do Prism adicionados.

Além da própria API — cada rota do painel agora aceita uma chave de API regular, a especificação OpenAPI é publicável em https://api.ssimplifi.com/v1/openapi.json, e a Swagger UI está montada em /v1/docs. O painel continua sendo a superfície mais amigável; ele simplesmente não é mais a única.

Por que três, e por que agora

A razão honesta é a fricção. Eu me vejo executando metade do meu próprio trabalho de desenvolvimento através de CLIs. Os engenheiros que mostrei o Prism também fazem o mesmo. Dizer a um desenvolvedor "faça login no painel da web para atualizar seu TTL de cache" quando eles estão atolados em uma implantação é a experiência do usuário errada. Se o produto é feito para desenvolvedores, toda superfície operacional precisa ser programável.

O MCP foi a decisão mais difícil. A Anthropic lançou o protocolo em outubro de 2024; até meados de 2026, todo cliente sério de codificação de IA fala isso. Esse é um canal de distribuição — quando um assistente de IA pode chamar seu gateway diretamente como uma ferramenta, a questão muda de "devo integrar o Prism" para "o Prism já está lá." Três meses atrás, isso teria sido especulativo. Agora é um requisito básico para qualquer produto de infraestrutura de IA voltado para desenvolvedores.

Os SDKs foram a vitória de menor custo. Temos dito aos clientes "somos compatíveis com OpenAI — apenas mude a URL base." Isso é tecnicamente correto, mas na prática, os cabeçalhos X-Prism-* (mode, session_id, cache) requerem extra_headers={"X-Prism-Mode": "..."} cerimônia em cada chamada. Um SDK de primeira parte que os expõe como kwargs do Python ou campos do TypeScript faz a API parecer um produto real em vez de "OpenAI mais cabeçalhos estranhos."

O que há de novo na API

A v1.8 P1 (a passagem de completude da API) é o pré-requisito para tudo o mais. Duas mudanças reais:

Autenticação dupla em cada rota do painel. Antes do P1a, os endpoints de gerenciamento de conta — cache, política, orçamento, auditoria, espaços de trabalho — exigiam um JWT do Supabase (ou seja, um login na web). Após o P1a, eles aceitam tanto o JWT quanto uma chave de API regular prism_sk_*. O caminho da chave é restrito por níveis: Pro/Team obtêm acesso programático; Free/PAYG recebem um erro limpo 402 tier_upgrade_required com uma URL de upgrade. Esta é a linha divisória que bloqueamos: consumo + seus próprios dados de uso é universal, orquestração operacional é Pro+.

Especificação OpenAPI + Swagger UI. Cada rota tem uma tag, uma descrição e um modelo de resposta. Webhooks estão explicitamente ocultos para que não vazem na especificação pública. O resultado são documentos publicáveis em https://api.ssimplifi.com/v1/openapi.json que clientes SDK gerados automaticamente podem consumir diretamente. A Swagger UI em /v1/docs oferece aos prospects uma superfície interativa antes de se inscreverem.

Esta é a parte chata da v1.8. É também a parte que desbloqueou tudo o mais — cada outra peça abaixo é uma camada fina sobre a superfície da API que o P1 tornou limpidamente programável.

O CLI

pip install ssimplifi-cli
prism configure              # cole sua chave prism_sk_...
prism chat "Qual é..."      # conclusão única, qualquer nível
prism models --provider groq
prism usage --days 7
prism cache stats

Dezenove comandos, ~40 subcomandos. Alguns são universais (chat, models, whoami, balance, usage, keys list). A maioria é Pro+ (cache, policy, budget, audit, orgs, projects, members, invites, subscription, provider-health).

A verificação de nível acontece de forma limpa. Se você tentar prism cache stats em uma conta Free, o CLI imprime:

Atualização de nível necessária.
  Nível atual: free
  Acesso programático a este endpoint requer Pro ($19/mês) ou Team ($49/mês).
  Upgrade: https://ssimplifi.com/pricing

Não é um 401 com um despejo JSON. Não é um estado meio quebrado. Uma mensagem limpa e acionável dizendo exatamente o que fazer.

O CLI também tem uma postura de soft-gate: prism chat e prism models funcionam em qualquer nível. Você pode instalar o CLI no Free, usar chat do seu terminal, descobrir que comandos administrativos existem e fazer upgrade quando realmente precisar deles. Isso parece certo — restringir o ponto de entrada da ferramenta afastaria desenvolvedores curiosos antes que eles experimentassem o produto.

O servidor MCP

Esta é a parte que mais estou animado. Uma vez que você tenha configurado o Claude Desktop (ou Cursor, ou Zed, ou Continue, ou Cline) com o servidor MCP do Prism, a IA pode chamar o catálogo do Prism, estimar custos, verificar seu uso, enviar feedback e — com a chave de escopo de escrita opcional — alterar configurações de cache, revogar chaves de API, definir política de roteamento. Tudo isso de dentro da conversa.

// ~/Library/Application Support/Claude/claude_desktop_config.json
{
  "mcpServers": {
    "prism": {
      "command": "prism-mcp",
      "env": {
        "PRISM_API_KEY": "prism_sk_..."
      }
    }
  }
}

22 ferramentas no total — 12 somente leitura, 10 de escrita. As ferramentas de escrita são restritas por duas camadas coordenadas:

Camada 1 — Confirmação por ferramenta. Cada ferramenta de escrita leva um argumento confirmed: boolean que padrão é falso. Sem isso, a ferramenta retorna uma resposta estruturada confirmation_required descrevendo a ação + suas consequências específicas. O cliente de IA apresenta as consequências para você em linguagem natural ("Isso irá revogar...")