Canopus dans votre assistant
Demandez à votre assistant comment s'est passée la semaine, quelle campagne a rapporté ou qui est un contact, depuis l'endroit où vous travaillez déjà. Dans le repo de votre SaaS, il lit aussi votre stratégie, votre client idéal et votre ton : la copie qu'il écrit dans votre code sonne comme votre marque.
Comment ça marche
Canopus fait tourner un serveur MCP distant en Streamable HTTP. Rien à installer : votre client se connecte à une URL.
Chaque accès est lié à un seul SaaS. Une clé ou un connecteur autorisé pour Edgely lit Edgely, et rien de vos autres SaaS.
Le serveur lit et rédige des brouillons. Il n'approuve jamais, n'envoie jamais de campagne ni de séquence, ne supprime jamais rien. Chaque réponse porte le lien de l'écran de Canopus où vous décidez.
https://www.canopushq.io/api/mcpClaude Code, avec une clé API
Dans le repo de votre SaaS, Claude Code se connecte avec une clé API.
Créer une clé
Dans Canopus, ouvrez Réglages, puis API, et créez une clé avec le droit Lecture. Copiez-la : elle ne s’affiche qu’une fois.
La ranger
Mettez-la dans l'environnement de votre terminal sous le nom CANOPUS_API_KEY. Ne la commitez jamais.
Ajouter le serveur
Lancez la commande ci-dessous dans votre repo, puis demandez à Claude le point de la semaine.
claude mcp add --transport http canopus https://www.canopushq.io/api/mcp \
--header "Authorization: Bearer $CANOPUS_API_KEY"Claude Desktop et claude.ai, en connecteur
Les connecteurs se connectent en OAuth : aucune clé à copier, et vous choisissez le SaaS et les droits sur un écran de Canopus.
Ajouter un connecteur personnalisé
Dans les réglages de votre assistant, ouvrez Connecteurs, ajoutez un connecteur personnalisé et collez https://www.canopushq.io/api/mcp.
Vous connecter à Canopus
Votre assistant ouvre Canopus. Connectez-vous comme d'habitude, double authentification et passkeys comprises.
Choisir le SaaS, puis les droits
Choisissez le SaaS sur lequel ce connecteur travaille, décochez les droits que vous ne voulez pas donner, et autorisez. Pour connecter un second SaaS, ajoutez le connecteur une seconde fois.
Déconnecter quand vous voulez
Dans Canopus, Réglages, puis Assistants connectés. Le prochain appel d'un assistant déconnecté est refusé.
Autres clients MCP
Tout client qui parle Streamable HTTP fonctionne, en OAuth ou avec une clé dans l'en-tête Authorization. Une configuration type :
{
"mcpServers": {
"canopus": {
"type": "http",
"url": "https://www.canopushq.io/api/mcp",
"headers": { "Authorization": "Bearer cnp_live_..." }
}
}
}Droits
Une clé reçoit ses droits à sa création ; un connecteur, quand vous l'autorisez. Un outil que vous n'avez pas accordé n'est même pas montré à l'assistant.
| Droit | Ce qu’il permet |
|---|---|
| read | Rapports, statistiques, revenu, CRM, stratégie et calendrier. |
| drafts:write | Brouillons de campagnes et de séquences, demandes au producteur de contenu et au stratège. |
| contacts:write | Contacts, notes et étapes. N’envoie rien. |
| events:write | Événements produit. Un événement inscrit la personne dans les séquences que vous avez approuvées : des e-mails peuvent partir. |
| transactional:send | Les e-mails de votre produit, par l'API d'e-mail ou par l'assistant. |
Outils
Chaque outil renvoie un court résumé, les chiffres derrière, et le lien vers l'écran de Canopus qui correspond.
| Outil | Ce qu’il renvoie | Droit |
|---|---|---|
| get_weekly_report | Le dernier rapport de la semaine et ce qui attend votre approbation. | read |
| get_attributed_revenue | Essais, clients et MRR attribués aux campagnes, aux séquences et aux sources. | read |
| get_sending_domain_status | Votre domaine d'envoi : vérification, expéditeur, taux de rebond et de plainte sur 7 jours. | read |
| get_email_quota | Les e-mails envoyés ce mois-ci face au quota de votre offre. | read |
| list_campaigns | Vos campagnes et leur statut, filtrables. | read |
| get_campaign_stats | Une campagne : variantes, destinataires et tout son entonnoir. | read |
| list_sequences | Vos séquences, leur déclencheur et les inscrits du moment. | read |
| get_sequence_stats | Une séquence : étapes, inscriptions et entonnoir. | read |
| search_contacts | Les contacts qui correspondent à un e-mail, un nom ou une entreprise. | read |
| get_contact | Un contact : attributs, étape et historique récent. | read |
| list_audiences | Les audiences, formats et déclencheurs de séquence utilisables. | read |
| create_campaign_draft | Une campagne en brouillon, avec ses messages et une variante B au besoin. | drafts:write |
| update_campaign_message | Réécrit un message d'une campagne pas encore approuvée. | drafts:write |
| add_campaign_message | Ajoute un message à la fin d'une campagne pas encore approuvée. | drafts:write |
| add_campaign_variant | Ajoute une version B du premier message, pour tester une différence. | drafts:write |
| create_sequence_draft | Une séquence en brouillon : son déclencheur, ses sorties et ses messages. | drafts:write |
| update_sequence_message | Réécrit un message d'une séquence qui ne tourne pas. | drafts:write |
| add_sequence_message | Ajoute un message à la fin d'une séquence qui ne tourne pas. | drafts:write |
| update_sequence_trigger | Change ce qui démarre et arrête une séquence qui ne tourne pas. | drafts:write |
| request_content_post | Demande au producteur de contenu un post sur un angle que vous donnez. | drafts:write |
| request_new_strategy | Demande au stratège une nouvelle version de la stratégie, en brouillon. | drafts:write |
| upsert_contact | Crée un prospect, ou met à jour le contact qui a cet e-mail. Les faits produit sont refusés. | contacts:write |
| add_contact_note | Ajoute une note à l'historique d'un contact. | contacts:write |
| move_contact_stage | Déplace un prospect vers une étape du pipeline. Une étape qui en fait un client est refusée : le fondateur convertit dans Canopus. | contacts:write |
| track_product_event | Un événement produit (inscription, essai, changement d’offre, départ) par le même chemin que le webhook CRM. | events:write |
| send_transactional_email | Un e-mail produit vers une adresse, comme POST /api/v1/emails. | transactional:send |
| get_transactional_email | Le statut de remise d'un e-mail transactionnel. | transactional:send |
Resources
Le contexte que votre assistant lit avant d'écrire quoi que ce soit pour votre SaaS.
| Resource | Ce qu’elle contient |
|---|---|
| canopus://strategy | La stratégie en vigueur : positionnement, segments, canaux, objectif. |
| canopus://icp | Votre profil de client idéal et ses segments. |
| canopus://tone | Votre ton, avec des exemples d'écriture. |
| canopus://product-brief | Ce que Canopus a appris de votre produit. |
| canopus://calendar | Le calendrier de contenu des six prochaines semaines. |
| canopus://email-api | La référence de l'API d'e-mail transactionnel, pour le droit transactional:send. |
Prompts
Des tâches toutes prêtes, proposées dans le menu de prompts de votre assistant.
| Prompt | Ce qu’il fait |
|---|---|
| weekly_review | La semaine en quelques lignes, ce qui vous attend, et la prochaine étape. |
| onboarding_audit | Le parcours d'inscription de votre code, comparé aux séquences que Canopus fait tourner. |
| announce_feature | Ce que vous avez livré, lu dans le code, transformé en brouillon de campagne, séquence d’activation et post. |
Ce que l'assistant ne peut jamais faire
- Approuver quoi que ce soit, ou envoyer une campagne ou une séquence. Ces outils n'existent pas : une page ou un fichier que lit votre assistant ne peut pas le pousser à s'en servir.
- Supprimer ou purger des données.
- Modifier une séquence qui tourne ou une campagne en cours d'envoi. Ces modifications restent les vôtres, dans Canopus.
- Atteindre un autre SaaS que celui auquel son accès est lié.
- Garder son accès après la révocation de la clé ou la déconnexion du connecteur.
Limites
- 60 appels par minute par clé ou par connecteur, à part de l'API d'e-mail.
- Le serveur MCP fait partie de toutes les offres payantes. Un SaaS sans abonnement actif ne peut pas être connecté, et ses clés et ses jetons sont refusés avec une explication et aucune donnée.
- Chaque appel est inscrit au journal d'audit avec la clé ou le connecteur qui l'a fait.