Condie MCP

Só de leitura

O Condie é um programa de gestão de condomínios para o mercado português. Este servidor MCP dá ao assistente de IA do gestor (Claude, ChatGPT ou outro cliente MCP) acesso de leitura à carteira da sua organização: edifícios, frações, proprietários e saldos, devedores, assembleias, ocorrências e prazos legais.

Nenhuma ferramenta escreve. Cada resposta fica limitada à organização autorizada e aos âmbitos escolhidos. As perguntas correm na conta do assistente; o Condie não cobra por pergunta.

Servidor: https://api.condie.pt/api/mcp
Transporte: Streamable HTTP, sem sessão (cada pedido é independente)
Autenticação: OAuth 2.1 com PKCE (S256) ou chave API do Condie
Ícone: https://api.condie.pt/api/mcp/icon.png
Privacidade: https://condie.pt/legal/privacidade
Termos: https://condie.pt/legal/termos-uso
Apoio: apoio@condie.pt

Ligar a partir de um diretório de conectores

Em claude.ai, no Claude Desktop ou no ChatGPT, adicione o conector Condie (ou um conector personalizado com o endereço do servidor). O cliente regista-se sozinho, leva-o a uma página do Condie onde inicia sessão com a sua conta de gestor, escolhe a organização e os âmbitos, e recebe um token. Não precisa de criar nenhuma chave.

Metadados do servidor de autorização: https://api.condie.pt/.well-known/oauth-authorization-server
Metadados do recurso protegido: https://api.condie.pt/.well-known/oauth-protected-resource/api/mcp
Registo de clientes: POST https://api.condie.pt/oauth/register (RFC 7591)
Autorização: GET https://api.condie.pt/oauth/authorize
Tokens: POST https://api.condie.pt/oauth/token (authorization_code com PKCE, refresh_token rotativo)
Revogação: POST https://api.condie.pt/oauth/revoke (RFC 7009)
Validade: token de acesso 1 hora; refresh token 30 dias, substituído a cada utilização

O gestor vê e remove as aplicações ligadas em Definições › Chaves API › Aplicações ligadas. Remover uma aplicação revoga todos os seus tokens de imediato.

Ligar com uma chave API

Em alternativa, crie uma chave em Definições › Chaves API e envie-a como Authorization: Bearer cda_.... A chave vale para este servidor e para a API pública v1, com os mesmos âmbitos.

claude mcp add --transport http condie https://api.condie.pt/api/mcp --header "Authorization: Bearer cda_A_SUA_CHAVE"

Ferramentas

Ferramenta	Âmbito	O que devolve
`list_buildings`	`buildings:read`	Lista os edifícios (condomínios) da organização, com morada, NIF e estado.
`get_building`	`buildings:read`	Ficha de um edifício: morada, NIF, exercício, limiar de mora, frações e totais.
`list_units`	`buildings:read`	Frações de um edifício, com permilagem, tipologia, localização e o titular atual.
`list_owners`	`owners:read`	Proprietários de um edifício com o saldo da conta corrente (positivo = deve). NIF, email e telefone só com o âmbito owners:contact.
`owner_balance`	`owners:read`	Saldo da conta corrente de um proprietário num edifício, com os últimos movimentos e a situação de mora.
`arrears`	`owners:read`	Devedores em mora por edifício, com antiguidade da dívida (0-30, 31-60, 61-90, 91-180, mais de 180 dias).
`balances_summary`	`owners:read`	Totais da conta corrente por edifício: quem deve, quem tem crédito, quanto está em mora.
`list_assemblies`	`buildings:read`	Assembleias de um edifício ou de toda a carteira, com data, tipo, convocatória e ata.
`get_assembly`	`buildings:read`	Uma assembleia com a ordem de trabalhos e o resultado de cada ponto.
`list_issues`	`buildings:read`	Ocorrências de um edifício ou de toda a carteira, filtráveis por estado e prioridade.
`upcoming_deadlines`	`buildings:read`	Prazos legais a vencer (carregadores, painéis solares, obras de conservação, cobrança judicial, prescrição, RCBE), por edifício ou carteira.
`search`	`owners:read`	Procura por nome ou fração em toda a organização: proprietários, frações e edifícios. Por NIF ou email só com o âmbito owners:contact.

Âmbitos

Os mesmos da API pública. buildings:read cobre frações, assembleias, ocorrências e prazos; owners:read cobre proprietários, saldos, devedores e pesquisa. O NIF, o email e o telefone dos proprietários só saem com owners:contact.

Âmbito	Dá acesso a
`buildings:read`	Edifícios
`owners:read`	Proprietários
`owners:contact`	Contactos e NIF dos proprietários
`payments:read`	Pagamentos
`expenses:read`	Despesas
`financialDocuments:read`	Documentos financeiros
`documentLinks:read`	Ligações a documentos

Dados e privacidade

O servidor só responde a quem tem uma autorização válida de uma organização; nada é público.
Cada chamada fica registada (ferramenta, hora, estado, número de registos), nunca os argumentos nem os resultados. O registo é visível ao gestor e apagado ao fim de 90 dias.
Os dados dos condóminos passam para o assistente que o gestor ligar. A organização tem de ter base legal para isso e informar os condóminos, como prevê o acordo de tratamento de dados.
Política de privacidade: https://condie.pt/legal/privacidade.