Pular para o conteúdo principal
Use a CLI para alterar o Phaseo a partir de um terminal ou script, ou conecte um cliente de IA ao servidor MCP do Phaseo para dar a ele dados do Phaseo em tempo real. Os dois fazem login com o OAuth do Phaseo.

CLI do Phaseo

Instale e faça login

Terminais interativos usam o OAuth pelo navegador por padrão. Para SSH, CI e ambientes sem interface, use a autorização por dispositivo:

Fluxos comuns

Use --json quando outra ferramenta ou script precisar de saída estruturada. Os valores secretos só são exibidos por comandos que os criam ou revelam explicitamente.

Guia da CLI do Phaseo

Veja as opções de autenticação, o gerenciamento de chaves, os espaços de trabalho, os guardrails e o fluxo completo de comandos.

MCP do Phaseo

A URL do servidor é https://mcp.phaseo.app/mcp. Um cliente de IA conectado a ela pode responder a perguntas com dados em tempo real sobre modelos, preços, provedores, uso e o espaço de trabalho.

Conecte o seu cliente

Instale com um clique: Adicionar ao Cursor · Adicionar ao VS Code. Quando o cliente pedir que você faça login, o Phaseo OAuth abre no seu navegador. Escolha um workspace e aprove os scopes de leitura solicitados.
Depois execute /mcp, selecione phaseo e escolha Authenticate. Adicione --scope user para disponibilizá-lo em todos os projetos.
Para outro cliente MCP, adicione a mesma URL como um servidor remoto Streamable HTTP. O cliente precisa suportar a descoberta OAuth, o authorization code com PKCE S256 e o parâmetro resource do MCP.

Use o login da CLI do Phaseo

Se você já usa a CLI do Phaseo, um agente local pode acessar o MCP por meio dela sem um segundo login:
phaseo mcp executa o MCP via stdio com o login da sua CLI. Ele troca esse login por um token de 15 minutos que só funciona no MCP, nunca tem mais acesso do que o seu login e nunca permite chamadas pagas a modelos. Ele é somente leitura, a menos que você adicione --manage. phaseo setup codex o adiciona ao perfil do Phaseo no Codex para você. Quando um agente conectado assim lê logs, atividade ou análises, o resultado também sugere o comando da CLI correspondente para os dados completos.

O que o MCP pode ler

As ferramentas somente leitura cobrem modelos, provedores, rankings de benchmarks, preços e estimativas de custo, além de créditos, atividade, análises, registros de solicitações e metadados de geração. Elas nunca retornam prompts, respostas nem valores secretos.

Gerencie a sua conta (opcional)

Para deixar um agente alterar o seu espaço de trabalho no Phaseo, conecte-se com a URL de gerenciamento: https://mcp.phaseo.app/mcp?access=manage
Ao entrar, a tela de consentimento lista cada permissão que a conexão pede, como gerenciar chaves de API ou excluir orçamentos, e a marca como Leitura, Gravação ou Exclusão. Desmarque as que você não quiser. O agente só recebe ferramentas para as permissões que você permitir, e o Phaseo continua verificando a sua função no espaço de trabalho a cada alteração, então um membro que não é proprietário nem administrador não consegue mudar por aqui configurações exclusivas de administradores. Se você já se conectou com a URL somente leitura, mude o cliente para a URL de gerenciamento e entre de novo. Para voltar ao acesso somente leitura, conecte-se de novo com a URL simples ou revogue o aplicativo em Configurações → Apps conectados. Uma conexão de gerenciamento lê tudo o que está abaixo, mas só altera chaves de API e configurações do espaço de trabalho. Orçamentos, regras de gastos, chaves de provedor, guardrails, predefinições, webhooks e destinos de observabilidade controlam gastos ou para onde vai o conteúdo das solicitações, então você os altera no painel ou com uma chave de gerenciamento. Ferramentas que alteram ou excluem algo são marcadas como tal, para que clientes MCP compatíveis peçam sua confirmação antes de cada chamada. Uma nova chave de API aparece uma vez no resultado da ferramenta e não pode ser mostrada de novo. Chaves de provedor armazenadas e credenciais de destinos nunca são retornadas. O MCP não tem ferramentas de cobrança, pagamento, espaço de trabalho, membros, chaves de gerenciamento nem aplicativos OAuth. Use o painel, a CLI ou a Management API para isso.

MCP da documentação

O MCP da documentação é um endpoint separado para pesquisar e ler a documentação do Phaseo. Ele não acessa a sua conta nem o seu espaço de trabalho.

Guia do MCP da documentação

Conecte o servidor de documentação ao Codex, ao Claude Code, ao Cursor, ao OpenCode ou ao VS Code.

Plugin do Phaseo

O plugin do Phaseo reúne o MCP do Phaseo, o MCP da documentação e as skills de agente do Phaseo para integração, migração, escolha de modelos, monitoramento de uso, os SDKs e a CLI. Instale-o uma vez em vez de conectar cada parte por conta própria.

Claude Code

Execute /mcp e entre em plugin:phaseo:phaseo para conectar a sua conta do Phaseo. As skills são carregadas quando uma solicitação corresponde a elas, ou você pode executar uma diretamente, como /phaseo:phaseo-gateway.

Codex

O último comando abre o OAuth do Phaseo para o MCP do Phaseo. As skills são carregadas quando uma solicitação corresponde a elas.
Última modificação em 16 de novembro de 2026