> ## Documentation Index > Fetch the complete documentation index at: https://docs.salvy.com.br/llms.txt > Use this file to discover all available pages before exploring further. # Requisitos técnicos Se você quer conectar um agente, aplicação ou ferramenta própria ao MCP da Salvy, esta página reúne os requisitos técnicos e o catálogo das ferramentas disponíveis. [A documentação principal](/mcp-guide/overview) explica o MCP de forma mais prática. Aqui você encontra os detalhes para quem precisa **configurar, desenvolver ou validar uma integração**. ## Antes de começar Para usar o MCP da Salvy, você precisa de: * uma conta ativa na Salvy; * acesso às empresas que deseja consultar ou gerenciar; * um cliente ou aplicação compatível com **MCP via Streamable HTTP**; * uma forma de autenticação válida; * permissões para realizar as operações desejadas. O MCP da Salvy está disponível em: ``` https://mcp.salvy.com.br/mcp ``` O endpoint utiliza **Streamable HTTP** e aceita requisições `POST`. *** ## Compatibilidade O MCP da Salvy utiliza o transporte **Streamable HTTP**, permitindo que clientes compatíveis com MCP se conectem diretamente ao servidor. A implementação atual: * utiliza `POST` para comunicação com o servidor; * não utiliza `stdio`; * não utiliza o transporte legado de `SSE`; * não mantém uma sessão entre requisições; * não exige `Mcp-Session-Id`. A compatibilidade final também depende do cliente de IA ou aplicação utilizado para fazer a conexão. *** ## Descoberta de ferramentas Depois de autenticar, o cliente pode consultar as ferramentas disponíveis no servidor usando `tools/list`. As ferramentas são organizadas em dois grandes grupos: * **Leitura:** consulta de informações da operação da Salvy; * **Escrita:** ações que alteram dados ou podem gerar efeitos na conta. O servidor informa as ferramentas disponíveis, seus parâmetros e suas descrições para que o cliente possa decidir qual utilizar. ### Importante A disponibilidade de uma ferramenta na descoberta **não significa que qualquer usuário possa executá-la**. Autenticação, permissões e regras da operação são verificadas quando a ferramenta é chamada. *** ## Catálogo de ferramentas Se você quer saber exatamente o que o MCP da Salvy pode fazer, este é o lugar. ### Leitura | Ferramenta | O que faz | | ---------------------------- | ----------------------------------------------------------------- | | `list_companies` | Lista as empresas às quais o usuário tem acesso. | | `list_phone_accounts` | Lista linhas e permite filtrar o parque por diferentes critérios. | | `get_phone_account` | Consulta os detalhes de uma linha específica. | | `get_phone_account_usage` | Consulta o consumo de dados de uma linha ou da empresa. | | `get_portability_status` | Consulta o status de uma portabilidade de entrada. | | `list_employees` | Lista colaboradores e permite localizar linhas associadas a eles. | | `list_cost_centers` | Lista os centros de custo de uma ou mais empresas. | | `list_invoices` | Lista faturas de uma ou mais empresas. | | `get_invoice` | Consulta os detalhes de uma fatura. | | `get_cost_by_cost_center` | Consulta a distribuição de custos por centro de custo. | | `get_current_month_estimate` | Consulta uma estimativa dos custos do mês atual. | ### Escrita | Ferramenta | O que faz | | -------------------------------------- | --------------------------------------------------- | | `create_phone_account` | Cria uma nova linha de telefonia. | | `add_data_to_phone_accounts` | Adiciona dados a linhas selecionadas. | | `change_subscription_plan` | Altera o plano de linhas selecionadas. | | `port_number` | Inicia uma portabilidade de entrada para uma linha. | | `block_phone_accounts` | Bloqueia linhas selecionadas. | | `unblock_phone_accounts` | Desbloqueia linhas elegíveis. | | `assign_phone_accounts_to_group` | Move linhas para um grupo. | | `assign_phone_accounts_to_cost_center` | Move linhas para um centro de custo. | | `create_phone_account_group` | Cria um grupo para organizar linhas. | | `submit_mcp_feedback` | Envia feedback sobre uma interação com o MCP. | *** ## Operações em lote Algumas ferramentas permitem trabalhar com várias linhas de uma vez. Os limites variam de acordo com a operação: * bloqueio e desbloqueio: até **50 linhas**; * organização em grupos: até **100 linhas**; * centro de custo: até **100 linhas**; * adição de dados: até **25 linhas** e **10 GB**; * alteração de plano: até **25 linhas**. As operações em lote respeitam as regras específicas de cada ferramenta. Quando uma operação é atômica, uma falha impede que parte da alteração seja aplicada. *** ## Resultados e estados As ferramentas podem retornar mais do que um simples `success` ou `error`. Algumas operações podem informar estados diferentes de uma execução concluída, como: * operação aplicada; * operação já aplicada; * operação agendada; * resultado indisponível para determinado período ou dado. Para operações assíncronas, o resultado inicial pode indicar que a solicitação foi aceita ou agendada. Nesse caso, uma nova consulta pode ser necessária para verificar o estado final. *** ## Para desenvolvedores Se você está construindo uma integração própria, recomendamos começar por: 1. conectar ao endpoint do MCP; 2. [configurar a autenticação](/mcp-guide/getting-started#autenticação); 3. executar `tools/list`; 4. selecionar uma ferramenta de leitura; 5. validar os parâmetros e o formato do resultado; 6. só depois habilitar operações de escrita. Para uma primeira integração, prefira começar com ferramentas de consulta. Isso permite validar autenticação, descoberta e interpretação dos resultados antes de introduzir operações que alteram dados ou geram cobrança. *** ## Referência rápida | Item | Valor | | ------------------ | ------------------------------ | | **Endpoint** | `https://mcp.salvy.com.br/mcp` | | **Transporte** | Streamable HTTP | | **Método** | `POST` | | **Sessão** | Stateless | | **Descoberta** | `tools/list` | | **Autenticação** | OAuth ou API Key | | **Capacidade MCP** | Tools | | **Recursos MCP** | Não disponíveis atualmente | | **Prompts MCP** | Não disponíveis atualmente |