Servidor MCP

O servidor MCP deixa um assistente de IA (Claude, Cursor e outros clientes MCP) consultar e operar a sua conta Vixpi, com as permissões que você aprovar.

Em preparação. O servidor ainda não está no ar em produção. O endereço e as ferramentas abaixo são os do serviço em desenvolvimento e podem mudar até a publicação.

Como conectar

O servidor usa o transporte Streamable HTTP neste endereço:

URL

https://mcp.vixpi.host/mcp

No Claude Code:

terminal

claude mcp add --transport http vixpi https://mcp.vixpi.host/mcp

Em clientes que leem um arquivo de configuração (Cursor, por exemplo), acrescente o servidor com a URL:

JSON

{
  "mcpServers": {
    "vixpi": {
      "url": "https://mcp.vixpi.host/mcp"
    }
  }
}

Você não cola chave nenhuma. Na primeira conexão o cliente se registra sozinho (registro dinâmico de cliente, RFC 7591), abre a tela de login e consentimento da Vixpi e mostra os escopos que ele pede. Depois de aprovar, o cliente guarda o token e renova sozinho. Esse cliente aparece em Apps autorizados, onde você revoga o acesso a qualquer momento. Detalhes do fluxo em Autenticação.

O registro automático só cria clientes públicos, que usam PKCE e nunca recebem client_secret, e nunca concede hosting:deploy nem acesso à caixa de e-mail.

Ferramentas de leitura

O MCP chama a mesma API desta documentação, então vale o escopo de cada rota. Se o token não tiver o escopo, a ferramenta devolve o erro INSUFFICIENT_SCOPE.

Ferramenta	O que faz	Escopo
`vixpi_list_services`	Lista os serviços da conta	`services:read`
`vixpi_get_service`	Detalha um serviço	`services:read`
`vixpi_list_invoices`	Lista as faturas	`billing:read`
`vixpi_get_invoice`	Detalha uma fatura	`billing:read`
`vixpi_get_credits`	Saldo e histórico de crédito	`billing:read`
`vixpi_list_tickets`	Lista os tickets	`tickets:read`
`vixpi_get_ticket`	Lê um ticket e as respostas	`tickets:read`
`vixpi_get_profile`	Perfil da conta	`account:read`
`vixpi_list_vps`	VPS de um serviço	`vps:read`
`vixpi_get_vps_metrics`	Métricas da VPS	`vps:read`
`vixpi_get_vps_traffic`	Tráfego da VPS	`vps:read`
`vixpi_list_vps_backups`	Backups da VPS	`vps:read`
`vixpi_get_hosting_account`	Conta de hospedagem	`hosting:read`
`vixpi_list_hosting_deployments`	Deploys da hospedagem	`hosting:read`
`vixpi_list_hosting_domains`	Domínios da hospedagem	`hosting:read`
`vixpi_list_hosting_backups`	Backups da hospedagem	`hosting:read`

Ferramentas de escrita e confirmação

Quem escreve pode causar dano, então as ações destrutivas só rodam com o parâmetro confirm igual ao identificador do recurso. O assistente precisa perguntar a você, receber o "sim" e só então repetir a chamada com o id. Sem isso a ferramenta recusa e não muda nada.

Ferramenta	O que faz	Escopo	Exige confirm
`vixpi_create_ticket`	Abre um ticket	`tickets:write`	não
`vixpi_reply_ticket`	Responde um ticket	`tickets:write`	não
`vixpi_cancel_service`	Pede o cancelamento de um serviço	`services:write`	sim: id do serviço
`vixpi_power_vps`	Liga, desliga ou reinicia uma VPS	`vps:write`	sim: id da VPS

Não existe ferramenta para comprar, pagar, apagar a conta ou ler a senha de uma VPS: essas ações ficam só no painel.

Servidor MCP

Como conectar

Login automático por OAuth

Ferramentas de leitura

Ferramentas de escrita e confirmação