# Programadores: ligar um software ou um assistente de IA

No menu da sua conta, abra «Programadores». A página chama-se «Cliente de API». Esta opção está visível no modo especialista e assinalada como BETA.

### Criar um cliente de API

A criação de clientes de API requer uma subscrição paga ou um período de avaliação ativo. Pode ter até 5 clientes.

1. Abra «Criar um cliente de API». Se já tiver um cliente, clique em «Nova chave de API».
2. Em «Identificador», dê um nome à sua integração para a reconhecer.
3. Clique em «Gerar uma chave de API» e guarde o `client_id` e o `client_secret`. O segredo só é apresentado uma vez.

<div class="alert">
<p><span class="lead">Importante</span></p>
<p>Mantenha o segredo confidencial, como uma palavra-passe. Utilize-o apenas no servidor, nunca em código do navegador ou numa aplicação pública. Não o cole numa conversa com um assistente de IA.</p></div>

### Ligar o seu software

O software troca estas credenciais por um token de acesso em `https://api2.rentila.com/oauth/token`, através de `client_credentials`. Depois utiliza o token para chamar a API. Reutilize-o até expirar e peça um novo.

Abra «Instruções de conexão» para ver exemplos de ligação e «Documentação da API» para consultar as operações e os parâmetros.

### Ligar um assistente através de MCP

1. No seu cliente compatível com MCP, adicione um servidor com o endereço `https://api2.rentila.com/mcp`.
2. Inicie a ligação. Na página Rentila que se abre no navegador, escolha o país da sua conta e introduza as suas credenciais habituais.
3. Introduza o código de autenticação de dois fatores, se solicitado, e volte ao cliente.

Não precisa de criar um cliente de API para esta ligação pelo navegador. Pode então perguntar: «Liste os meus imóveis» ou «Que rendas recebi em outubro?». Algumas operações alteram os seus dados: verifique o pedido e as confirmações apresentadas pelo cliente.

O botão «Claude MCP» copia uma ligação de configuração para abrir no navegador. «Claude Code», «Codex» e «Cursor» copiam um texto de configuração para utilizar na ferramenta escolhida. Introduza a palavra-passe apenas na página de início de sessão Rentila.

### Gerir os seus clientes de API

A lista apresenta o nome, o `client_id`, a data de criação e o último acesso. O segredo permanece oculto. Para eliminar um cliente, utilize o ícone do caixote do lixo e confirme.

Se perder o segredo, crie um novo cliente e atualize o software. Em caso de divulgação, elimine também o cliente comprometido. Se atingiu o limite de 5 clientes, elimine um que já não utilize antes de criar outro.

---

https://www.rentila.pt/support/developers-api-mcp
