Documentation
API et MCP
Connecter un assistant IA à votre compte, recevoir des webhooks, gérer vos clés. Plan Pro.
Sur cette page
L'API externe (clés, webhooks, MCP) fait partie du plan Pro. Un compte gratuit reçoit une erreur 403.
Connecter un assistant IA (MCP)
Le serveur MCP de GoLynk, https://mcp.golynk.ch, permet à un assistant IA (Claude, ChatGPT, Le Chat de Mistral, Cursor…) de lire votre compte et de préparer des actions en votre nom, en langage courant : « liste mes factures impayées », « crée un devis pour… ».
Ouvrez freelance.golynk.ch/connect-ai : l'assistant de connexion crée une clé avec le bon droit et donne les réglages à copier pour votre outil.
Dans votre assistant, ajoutez un connecteur MCP avec l'adresse https://mcp.golynk.ch et la clé (en-tête Authorization: Bearer gkl_…).
Demandez-lui ce que vous voulez savoir ou faire. Toute écriture (création, envoi, suppression) est soumise à votre confirmation.
Limite par défaut : 100 requêtes par heure et par clé.
Clés API
- Une clé a la forme
gkl_…. Elle n'est affichée qu'une fois, à sa création : GoLynk n'en garde qu'une empreinte et ne peut pas la retrouver. - Les clés se gèrent dans freelance.golynk.ch/API/api-key : plusieurs clés, droits (scopes) choisis par clé, limite de débit, expiration, révocation.
- Droits disponibles :
clients:read,clients:write,invoices:read,invoices:write,expenses:read,expenses:write,accounting:read,accounting:write,stats:read,sales:write,mcp:read. - Gardez la clé comme un mot de passe : jamais dans un dépôt de code, toujours dans une variable d'environnement ou un gestionnaire de secrets. En cas de doute, révoquez-la et créez-en une autre.
Webhooks sortants
GoLynk envoie une requête POST à votre serveur à chaque événement choisi. Les adresses se gèrent dans freelance.golynk.ch/API/webhook, avec un secret par adresse et le journal des envois.
- Événements :
invoice.created,invoice.paid,invoice.cancelled,client.created,client.updated,expense.created,payment.received,accounting.entry_created. - En-tĂŞtes :
X-GoLynk-Event(l'événement),X-GoLynk-Timestamp(secondes Unix),X-GoLynk-Signature(sha256=suivi de la signature). - La signature est un HMAC-SHA256, avec votre secret, de la chaîne
horodatage.corps(l'horodatage, un point, puis le corps brut de la requête). Vérifiez-la avant de traiter la requête, et refusez un horodatage trop ancien. - En cas d'échec, l'envoi est retenté jusqu'à trois fois.
API REST
L'API REST publique (lecture et écriture des clients, factures, écritures, projets et produits) n'est pas encore ouverte. Son adresse et sa référence seront publiées ici à l'ouverture. En attendant, le serveur MCP et les webhooks couvrent la plupart des besoins ; pour envoyer des ventes depuis votre site, voir Ventes externes.