--- title: "Compreender o conector MCP Billabex" canonical: https://www.billabex.com/pt/ajuda/billabex-com-ia/compreender-conector-mcp/ lang: pt alternate: https://www.billabex.com/es/ayuda/billabex-con-ia/comprender-el-conector-mcp-de-billabex.md alternates: pt: https://www.billabex.com/pt/ajuda/billabex-com-ia/compreender-conector-mcp.md es: https://www.billabex.com/es/ayuda/billabex-con-ia/comprender-el-conector-mcp-de-billabex.md it: https://www.billabex.com/it/assistenza/billabex-con-ia/comprendere-connettore-mcp.md fr: https://www.billabex.com/fr/aide/billabex-avec-ia/comprendre-connecteur-mcp.md nl: https://www.billabex.com/nl/hulp/billabex-met-ai/mcp-connector-begrijpen.md de: https://www.billabex.com/de/hilfe/billabex-mit-ki/den-mcp-connector-von-billabex-verstehen.md pl: https://www.billabex.com/pl/pomoc/billabex-z-ai/poznaj-konektor-mcp.md en: https://www.billabex.com/en/help/billabex-with-ai/understand-billabex-mcp-connector.md updated: 2026-11-09 index: https://www.billabex.com/llms.txt --- # Compreender o conector MCP Billabex

Em resumo

O conector MCP liga um assistente compatível aos dados e ações Billabex sem lhe transmitir a sua palavra-passe. O cliente descobre as capacidades do servidor remoto e OAuth leva-o depois a rever e autorizar os acessos pedidos. O assistente atua então exatamente com os seus direitos. Teste-o primeiro com uma leitura numa organização conhecida e mantenha a aprovação manual para qualquer alteração.

## Resultado esperado O seu cliente de IA liga-se ao servidor oficial Billabex, autentica-se por OAuth e consegue realizar uma primeira verificação em leitura. ## Antes de começar - Utilize um cliente que aceite servidores MCP remotos protegidos por OAuth. Para o ChatGPT, [instale antes o plugin Billabex publicado](https://www.billabex.com/pt/ajuda/billabex-com-ia/ligar-billabex-chatgpt/). - Obtenha o URL do conector na Billabex, nunca numa mensagem não verificada: **Definições**, separador **Assistentes de IA e API**, ou janela **O seu agente** aberta a partir do menu lateral. ## Procedimento 1. Em **Definições > Assistentes de IA e API**, clique em **Ver as instruções** no cartão Claude ou Dust e depois em **Copiar** junto a **URL do servidor MCP**. 2. No seu cliente de IA, adicione um servidor MCP remoto chamado **Billabex** e cole esse URL. 3. Inicie a ligação, autentique-se na Billabex com a conta correta e leia **O que a aplicação poderá fazer**: **Acesso de IA só de leitura**, **Acesso de IA em escrita**. 4. Clique em **Autorizar** apenas se estes acessos corresponderem à sua necessidade; caso contrário, em **Recusar**. Se a escrita não for útil, desative as ferramentas de escrita no cliente ou mantenha a respetiva aprovação manual. 5. Peça ao cliente que liste as suas organizações ou resuma um cliente conhecido e compare a resposta com a Billabex. Guias passo a passo abrangem [a ligação ao Claude](https://www.billabex.com/pt/ajuda/billabex-com-ia/ligar-billabex-claude/) e [a adição do servidor no Dust](https://www.billabex.com/pt/ajuda/billabex-com-ia/ligar-billabex-dust/). ## O que faz a Billabex O cliente comunica com o servidor MCP remoto e passa por OAuth antes de aceder à Billabex. Ferramentas, recursos e prompts disponíveis dependem dos [âmbitos concedidos](https://www.billabex.com/pt/ajuda/billabex-com-ia/permissoes-leitura-escrita/), e cada chamada respeita o seu papel na organização visada. O URL serve para configurar o cliente; não é uma página para abrir diretamente no navegador. O detalhe do protocolo consta da [referência técnica MCP e API](https://www.billabex.com/pt/ajuda/billabex-com-ia/referencia-tecnica-mcp-api/). Entre as ações possíveis, um assistente pode exportar a lista filtrada das faturas ou das notas de crédito em formato Excel, através de uma ligação de descarregamento válida durante 15 minutos. Para importar uma fatura, o ChatGPT pode transmitir diretamente o ficheiro anexado à conversa; caso contrário, e com os outros clientes, o assistente dá-lhe uma ligação pessoal de carregamento Billabex, válida durante 15 minutos, onde verifica o cliente, as datas e os montantes antes de escolher o documento e confirmar a importação. Se o cliente da fatura ainda não existir na Billabex, o assistente propõe criá-lo a partir das informações da fatura e aguarda a sua confirmação; um número de fatura já existente é recusado em vez de duplicado. ## Se o resultado não for o esperado - Não utilize a abertura do URL no navegador como teste de funcionamento do conector. - Se a autenticação não terminar, desligue e volte a ligar o cliente uma única vez. - Nunca transmita palavras-passe, tokens OAuth nem o cabeçalho Authorization ao suporte. ## Fontes oficiais - [Introdução ao protocolo MCP](https://modelcontextprotocol.io/docs/getting-started/intro), para compreender a descoberta de capacidades na integração.