Aller au contenu

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/mcp

Claude Code, avec une clé API

Dans le repo de votre SaaS, Claude Code se connecte avec une clé API.

  1. 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.

  2. La ranger

    Mettez-la dans l'environnement de votre terminal sous le nom CANOPUS_API_KEY. Ne la commitez jamais.

  3. 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.

  1. 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.

  2. Vous connecter à Canopus

    Votre assistant ouvre Canopus. Connectez-vous comme d'habitude, double authentification et passkeys comprises.

  3. 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.

  4. 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.

DroitCe qu’il permet
readRapports, statistiques, revenu, CRM, stratégie et calendrier.
drafts:writeBrouillons de campagnes et de séquences, demandes au producteur de contenu et au stratège.
contacts:writeContacts, 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:sendLes 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.

OutilCe qu’il renvoieDroit
get_weekly_reportLe dernier rapport de la semaine et ce qui attend votre approbation.read
get_attributed_revenueEssais, clients et MRR attribués aux campagnes, aux séquences et aux sources.read
get_sending_domain_statusVotre domaine d'envoi : vérification, expéditeur, taux de rebond et de plainte sur 7 jours.read
get_email_quotaLes e-mails envoyés ce mois-ci face au quota de votre offre.read
list_campaignsVos campagnes et leur statut, filtrables.read
get_campaign_statsUne campagne : variantes, destinataires et tout son entonnoir.read
list_sequencesVos séquences, leur déclencheur et les inscrits du moment.read
get_sequence_statsUne séquence : étapes, inscriptions et entonnoir.read
search_contactsLes contacts qui correspondent à un e-mail, un nom ou une entreprise.read
get_contactUn contact : attributs, étape et historique récent.read
list_audiencesLes audiences, formats et déclencheurs de séquence utilisables.read
create_campaign_draftUne campagne en brouillon, avec ses messages et une variante B au besoin.drafts:write
update_campaign_messageRéécrit un message d'une campagne pas encore approuvée.drafts:write
add_campaign_messageAjoute un message à la fin d'une campagne pas encore approuvée.drafts:write
add_campaign_variantAjoute une version B du premier message, pour tester une différence.drafts:write
create_sequence_draftUne séquence en brouillon : son déclencheur, ses sorties et ses messages.drafts:write
update_sequence_messageRéécrit un message d'une séquence qui ne tourne pas.drafts:write
add_sequence_messageAjoute un message à la fin d'une séquence qui ne tourne pas.drafts:write
update_sequence_triggerChange ce qui démarre et arrête une séquence qui ne tourne pas.drafts:write
request_content_postDemande au producteur de contenu un post sur un angle que vous donnez.drafts:write
request_new_strategyDemande au stratège une nouvelle version de la stratégie, en brouillon.drafts:write
upsert_contactCrée un prospect, ou met à jour le contact qui a cet e-mail. Les faits produit sont refusés.contacts:write
add_contact_noteAjoute une note à l'historique d'un contact.contacts:write
move_contact_stageDé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_eventUn événement produit (inscription, essai, changement d’offre, départ) par le même chemin que le webhook CRM.events:write
send_transactional_emailUn e-mail produit vers une adresse, comme POST /api/v1/emails.transactional:send
get_transactional_emailLe 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.

ResourceCe qu’elle contient
canopus://strategyLa stratégie en vigueur : positionnement, segments, canaux, objectif.
canopus://icpVotre profil de client idéal et ses segments.
canopus://toneVotre ton, avec des exemples d'écriture.
canopus://product-briefCe que Canopus a appris de votre produit.
canopus://calendarLe calendrier de contenu des six prochaines semaines.
canopus://email-apiLa 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.

PromptCe qu’il fait
weekly_reviewLa semaine en quelques lignes, ce qui vous attend, et la prochaine étape.
onboarding_auditLe parcours d'inscription de votre code, comparé aux séquences que Canopus fait tourner.
announce_featureCe 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.