# Ligar o seu assistente de IA

O Simafri ERP liga-se ao seu assistente de IA por **MCP** (Model Context Protocol), o protocolo aberto que o Claude, o ChatGPT e os principais assistentes falam. Uma vez ligado, o seu assistente conduz a sua gestão consigo: prepara os seus orçamentos, emite as suas faturas, regista os seus recebimentos, prepara os seus avisos de cobrança, regista as suas compras e reconcilia o seu banco, em todas as sociedades da sua conta.

|                                 |                                                                                        |
| ------------------------------- | -------------------------------------------------------------------------------------- |
| **Servidor MCP do Simafri ERP** | `https://erp-mcp.simafri.com/mcp`                                                      |
| **Transporte**                  | HTTP streamable                                                                        |
| **Ligação**                     | conector autorizado a partir do seu espaço [erp.simafri.com](https://erp.simafri.com/) |

## O que o seu assistente faz da sua gestão

| Domínio                      | O que o assistente faz                                                                                                                                               |
| ---------------------------- | -------------------------------------------------------------------------------------------------------------------------------------------------------------------- |
| **Vendas**                   | prepara um orçamento, uma fatura ou uma nota de crédito, acrescenta e retira linhas, emite o documento com a sua numeração, transforma um orçamento aceite em fatura |
| **Faturação recorrente**     | prepara uma fatura que volta todos os meses ou todos os anos, suspende-a, retoma-a, produz o vencimento do dia                                                       |
| **Recebimentos**             | regista um recebimento, imputa-o a uma ou várias faturas, cria uma ligação de pagamento online, lança os avisos das faturas vencidas                                 |
| **Compras**                  | regista uma fatura recebida, reparte-a por taxa de IVA, regista e imputa o pagamento ao fornecedor                                                                   |
| **Banco**                    | carrega um extrato, reconcilia cada movimento com o recebimento ou o pagamento correspondente, põe de lado um movimento sem comprovativo                             |
| **Existências**              | lê o nível de cada artigo, regista uma entrada, uma saída ou um inventário, regula o limiar de aviso                                                                 |
| **Contabilidade**            | lê o plano de contas e o seu mapeamento, exporta o diário de um período para o seu contabilista                                                                      |
| **Clientes, catálogo e CRM** | cria e atualiza um cliente, um fornecedor ou um artigo, conduz as suas campanhas de prospeção e o histórico de cada contacto                                         |
| **Comprovativos**            | anexa uma digitalização a um documento e relê um comprovativo já anexado                                                                                             |
| **Visão de conjunto**        | lê as suas sociedades, as suas definições de faturação, as suas moedas e as suas taxas de câmbio                                                                     |

O que o seu assistente regista fica registado exatamente como no ecrã: a mesma numeração, os mesmos controlos, o mesmo registo de atividade, em nome da sua conta.

### O que lhe pode pedir

* «Faz um orçamento à sociedade Martin para três dias de formação, ao preço do catálogo.»
* «O orçamento D-2026-0142 foi aceite: transforma-o em fatura, emite-a e cria a ligação de pagamento.»
* «Quem me deve dinheiro, e desde quando? Lança os avisos previstos.»
* «Aqui está o extrato do banco do mês: carrega-o e reconcilia o que for possível.»
* «Regista a fatura do fornecedor em anexo, repartida a 20 %, e prepara o seu pagamento.»
* «Exporta o diário do trimestre para o meu contabilista.»

## Ligar por conector

É o caminho mais simples: nada a copiar, nada a colar. Serve os assistentes que adicionam um servidor MCP pelo seu endereço, como os conectores do Claude e do ChatGPT.

1. No seu assistente, adicione um **conector personalizado** e indique-lhe o endereço `https://erp-mcp.simafri.com/mcp`.

2. O assistente abre o seu espaço [erp.simafri.com](https://erp.simafri.com/): inicie sessão com um acesso de nível **Propriétaire** (Proprietário).

3. A página de autorização mostra o programa que pede o acesso e o endereço para onde o reencaminhará. Escolha **o que poderá fazer**:

   <!-- -->

   * **Lecture seule** (Só leitura): consulta os seus livros;
   * **Lecture et écriture** (Leitura e escrita): consulta e regista, tal como o faria no ecrã.

4. Clique em **Autoriser** (Autorizar). As ferramentas do Simafri ERP aparecem no seu assistente: peça-lhe, por exemplo, a lista das suas faturas do mês.

A ligação vale para **todas as sociedades da conta**, incluindo as que abrir mais tarde. Ligar o mesmo assistente uma segunda vez atualiza a ligação existente.

## Ligar por chave

Para um programa em que define os cabeçalhos por si próprio (Claude Code, um programa da sua empresa), o Simafri ERP liga-se também por **chave API**. Dirija o pedido ao seu **canal de apoio Simafri**, indicando o alcance pretendido, leitura ou escrita: entregamos-lhe a chave. Com o Claude Code:

```
claude mcp add --transport http --scope user simafri-erp https://erp-mcp.simafri.com/mcp --header "Authorization: Bearer A_SUA_CHAVE"
```

## Ver e retirar uma ligação

O ecrã **Connecteurs** (Conectores), no grupo **Le compte** (A conta) do menu da esquerda, lista os programas ligados à sua conta. Cada linha indica o programa, o que pode fazer, a pessoa que o autorizou, a data da ligação e a sua última utilização.

**Révoquer** (Revogar) corta a ligação de imediato e por completo: o programa perde o acesso no mesmo segundo, em todas as suas sociedades. Para o voltar a ligar, basta repetir a autorização.

## Estamos aqui para ajudar

Passe pelo seu **canal de apoio Simafri** indicando o assistente que utiliza: acompanhamo-lo na ligação.
