Connecteur MCP (technique)
Point de terminaison Streamable HTTP, authentification OAuth ou clé, et portefeuille partagé avec le Studio.
Le connecteur IA Fonciq (produit distinct de l’API HTTP) expose le Registre foncier du Québec aux assistants compatibles MCP. La documentation utilisateur — ChatGPT, Claude, exemples de questions, facturation en cabinet — est sur mcp.fonciq.ca. Cette page résume ce dont un développeur ou un intégrateur a besoin côté API.
Point de terminaison
| URL canonique | https://mcp.fonciq.ca/v1/ |
| Transport | Streamable HTTP (JSON-RPC, sans session) |
| Alias réseau | https://mcp.fonciq.ca/v1/mcp, https://mcp.fonciq.ca/v1 |
Sur api.fonciq.ca, l’alias https://api.fonciq.ca/v1/mcp pointe vers le même serveur MCP (voir Premier appel pour l’API HTTP v1).
Authentification
Deux modes, selon le client MCP :
- OAuth 2.0 — émetteur
https://fonciq.ca. Utilisé par ChatGPT (connecteur personnalisé), Claude (annuaire ou configuration) et tout client qui suit le flux MCP OAuth. L’utilisateur consent au portefeuille et aux comptes Registre de son organisation. - Clé d’API — en-tête
Authorization: Bearer fq_test_…oufq_live_…, créée dans le Studio (section développeur). Même clé que pour l’API HTTP v1.
Métadonnées OAuth ressource protégée : https://mcp.fonciq.ca/.well-known/oauth-protected-resource.
Portefeuille et facturation
Les appels facturables passent par le même portefeuille Fonciq que le Studio : solde, mode Test (fq_test_) et plafond journalier par connexion OAuth s’appliquent de la même façon. Détail des tarifs sur fonciq.ca/tarifs.
Référence des outils MCP
Liste générée depuis le serveur (équivalent tools/list) :
| Outil | Clé requise | Paramètres |
|---|---|---|
flood_zones_lookupQuébec flood zones at a point, address or lot (free) / Zones inondables au Québec (gratuit) | Non | lat, lon, address, lot, lang |
lot_resolveResolve an address or matricule to lot numbers / Résoudre une adresse ou un matricule | Oui | address, matricule |
lot_getStored lot profile / Fiche d’un lot | Oui | lot |
registre_index_requestOrder a land-registry index / Commander un index | Oui | lot, rf_account_id, idempotency_key |
acte_getGet one deed PDF / Obtenir le PDF d’un acte | Oui | registration_number, circonscription, rf_account_id, idempotency_key |
plan_getGet a cadastral plan / Obtenir un plan cadastral | Oui | lot, cadastre, rf_account_id, idempotency_key |
job_getJob status / État d’une tâche | Oui | id |
job_resultsParsed index lines of a job / Lignes d’index d’une tâche | Oui | id |
document_getDownload a document PDF / Télécharger le PDF d’un document | Oui | id |
document_entriesParsed lines of one index document / Lignes d’un index | Oui | id |
batch_submitQueue many lots / Soumettre un lot groupé | Oui | lots, rf_account_id, idempotency_key |
watch_createWatch a lot / Surveiller un lot | Oui | lot, url, cadence, rf_account_id, idempotency_key |
billing_getRegistre fees per account / Frais du Registre par compte | Oui | rf_account_id, from, to |
billing_usageRegistre fee lines / Lignes de frais du Registre | Oui | rf_account_id, from, to, limit, cursor |
platform_billing_getFonciq platform wallet / Portefeuille plateforme Fonciq | Oui | — |
Descriptions complètes : réponse tools/list sur https://mcp.fonciq.ca/v1/.
Erreurs HTTP et limites de débit : alignées sur Erreurs et Limites de l’API v1.