CONFIGURATION DES AGENTS

Connecter un serveur MCP personnalisé

Comment connecter un serveur MCP personnalisé ?

Capabilities est l'endroit où vous donnez à votre agent un accès au-delà de Synup : votre CRM, votre boîte de réception, votre agenda, vos propres données. Ouvrez Sydekick → Agent → Capabilities. Certaines capacités sont incluses dans votre forfait, et vous pouvez en rechercher bien d'autres dans Discover. Cherchez-y d'abord. Utilisez Add custom server lorsque l'outil ne figure pas dans le catalogue et publie sa propre adresse MCP, ou lorsque vous disposez d'une API REST avec une clé.

La page Capabilities avec le bouton Add custom server, la section Connected avec ses filtres, et des cartes pour les capacités incluses, un serveur à configurer, un serveur MCP personnalisé prêt et un serveur en pause

Points clés

Où la trouverSydekick → Agent → Capabilities
Ajouter la vôtreAdd custom server, en haut à droite, ouvre un menu avec MCP server et Custom API
Deux groupesConnected (ce que votre agent peut atteindre) et Discover (un catalogue à parcourir)
Filtres de ConnectedAll, Connected apps, MCP servers, APIs, Built-in, une pastille Needs attention, un filtre texte et Who
États des cartesIncluded, Ready, Needs setup, Paused, Connecting, Not working
Qui peut l'utiliserLinked clients sur une carte choisit les clients auxquels une capacité s'applique
Accès à la pageL'accès à Capabilities se définit par membre de l'équipe

Étapes

  1. Ouvrez Sydekick → Agent → Capabilities. Si la page indique Starting up your agent, patientez ; elle réessaie d'elle-même.

  2. Lisez d'abord Connected. La ligne sous le titre compte ce que l'agent peut atteindre et combien de cartes nécessitent de l'attention. Utilisez les onglets, Needs attention, la zone de filtre ou Who pour réduire le nombre de cartes.

  3. Recherchez dans Discover l'outil que vous voulez. Tout ce que vous y connectez apparaît sous Connected.

  4. Si l'outil ne figure pas dans le catalogue, sélectionnez Add custom server et choisissez MCP server (ou Custom API).

  5. Remplissez la boîte de dialogue et sélectionnez Add server. Synup enregistre le serveur et tente de se connecter immédiatement. Si l'éditeur prend en charge la connexion, vous êtes dirigé vers son écran de consentement puis ramené ici.

  6. Vérifiez la nouvelle carte. Ready signifie que votre agent peut l'utiliser. Si elle indique Needs setup ou Not working, utilisez Configure ou Reconfigure sur la carte.

  7. Sélectionnez Linked clients pour choisir les clients auxquels la capacité s'applique.

Lisez la page en deux groupes

Le sous-titre de la page indique « Connect apps your agent can use and choose which clients each serves. » Tout ce que vous pouvez atteindre est une carte sous Connected, qu'il s'agisse d'une application connectée, d'un serveur MCP, d'une API ou d'un élément intégré, et les onglets filtrent cette liste unique. En dessous, Discover est un catalogue : saisissez un nom ou choisissez une pastille telle que Customer records, Reviews & reputation, Email & messaging, Scheduling ou Payments. Discover liste des applications tierces extérieures à Synup : son offre peut donc changer, et c'est la voie à suivre pour presque tout.

Ce que signifient les états des cartes

Le badge d'une carte vous indique qui en est responsable et si votre agent peut l'utiliser en ce moment.

  • Included : inclus dans votre forfait, rien n'est demandé de votre part. La carte indique « Account-wide · managed for you ». Les capacités incluses aujourd'hui sont par exemple l'extraction de pages web, les données SEO et la recherche web ; cet ensemble peut changer.
  • Ready : « Your agent can use this now. » Un serveur que vous avez connecté comporte Reconfigure, Linked clients et Disconnect.
  • Needs setup : « Your agent can't use this yet — it still needs credentials. » Utilisez Configure.
  • Paused : « Set up, but switched off. Your agent won't call it. »
  • Connecting : « Waiting for you to approve access. » Une autorisation est en cours.
  • Not working : « Your agent tried to use this and was refused. » Cela signifie généralement qu'une clé a été renouvelée ou qu'un accès a été révoqué de l'autre côté. Reconfigure est la solution.

Un serveur que vous avez ajouté manuellement affiche un petit badge MCP et son adresse sur la carte.

Ajouter votre propre serveur

Sélectionnez Add custom server, puis MCP server.

Le menu Add custom server avec les choix MCP server et Custom API

La boîte de dialogue Add a custom MCP server est courte.

La boîte de dialogue Add a custom MCP server avec les champs Name, URL et Description, Advanced settings ouvert montrant les lignes Header et les champs OAuth client ID et secret, et une ligne indiquant Only add servers from vendors you trust

Name est un libellé court (par exemple notion). URL doit être une adresse complète telle que https://mcp.vendor.com/mcp; ; une adresse partielle est refusée. Description (optional) s'adresse à la personne qui lira cette page après vous. Sélectionnez ensuite Add server : Synup l'enregistre et tente d'abord de se connecter de lui-même, et la plupart des serveurs ne nécessitent rien d'autre.

Advanced settings est replié par défaut. Ne l'ouvrez que si la documentation de l'éditeur vous l'impose : une ligne Header(s) pour une simple clé API (un nom tel que Authorization et sa valeur), ou un OAuth client ID et un OAuth client secret si l'éditeur vous a fourni un couple. Sa propre note indique : « Usually unnecessary. Use only if the vendor's docs require app registration. »

Deux issues sont à connaître :

  • Si l'éditeur le prend en charge, vous êtes redirigé vers son écran de consentement, puis ramené ici. À votre retour, la carte indique Ready, et la page affiche Connected "name". Your agent starts using it the next time it refreshes.
  • S'il ne s'est pas connecté automatiquement, la boîte de dialogue indique « Added "name". Didn't connect automatically. If the vendor requires a manually-registered app, expand Advanced settings, add its client ID (and secret, if issued), and click Add again. » Le serveur est enregistré ; réessayez avec les identifiants.

Un nom déjà utilisé est refusé : « A server named "name" is already registered. Disconnect it first if you want to reconnect under this name. »

Ajouter plutôt un(e) API personnalisé(e)

Si vous disposez d'une API REST et d'une clé plutôt que d'un serveur MCP, choisissez Custom API.

La boîte de dialogue Add a custom API avec les champs Who can use it, Name, Base URL, Sign-in method, Key et Endpoints

Elle indique « Sydekick and your clients' portal cards can read data from this API. Your key is stored securely and never shown again. » Vous choisissez Who can use it (tous les clients liés, ou un seul client), lui donnez un Name et une https:// Base URL (les requêtes ne vont qu'à cette adresse), choisissez la méthode de connexion et collez la Key ; après l'enregistrement, seuls ses quatre derniers caractères sont affichés. Endpoints est facultatif, un par ligne, par exemple /v1/summary, et Sydekick et les cartes ne lisent que les points de terminaison que vous listez. Une carte API comporte un bouton Test qui indique si la API a répondu avec la clé.

Choisir quels clients peuvent l'utiliser

La boîte de dialogue Linked clients d'un serveur personnalisé, avec une liste Select a client, un Account ID facultatif, un bouton Link et la ligne No clients linked yet

Linked clients ouvre Linked clients — name. Choisissez un client, ajoutez un identifiant de compte si le service en exige un, puis sélectionnez Link. Un serveur que vous avez ajouté manuellement affiche All clients sur sa carte tant que vous n'avez pas lié de clients précis ; les capacités Included sont par conception valables pour tout le compte et n'ont pas ce contrôle. Lorsque les clients peuvent connecter leur propre compte, la boîte de dialogue propose Connect their account ou Use agency account pour chacun, et le dernier client lié ne peut pas être dissocié sans rendre la capacité disponible à tous les clients : liez donc d'abord un autre client ou supprimez le serveur.

Deux types de « connexion »

Cette page explique comment donner à Sydekick un accès à d'autres outils. Permettre à un assistant IA externe, tel que Claude ou ChatGPT, d'utiliser votre compte Synup via MCP est une autre fonctionnalité, configurée sous Developer, qui nécessite un forfait payant. Ne confondez pas les deux.

Ce que vous verrez une fois terminé

  • Une nouvelle carte sous Connected, avec un badge MCP ou API et l'état Ready
  • La capacité disponible pour les clients que vous avez liés
  • L'agent qui l'utilise lors de sa prochaine actualisation

Points d’attention

Un serveur MCP peut lire et agir en votre nom dans le compte auquel vous le connectez. La boîte de dialogue le dit aussi : Only add servers from vendors you trust. Privilégiez Discover lorsque la connexion y figure déjà.
Disconnect ou Remove retire la capacité à tous les clients à la fois, et tout ce qui en dépend, comme une compétence ou une étape de playbook, cesse tout simplement de pouvoir accomplir cette partie de sa tâche. Vérifiez Linked clients avant d'en supprimer un.
  • Needs setup et Not working signifient tous deux que l'agent ne l'utilise pas. Corrigez les identifiants avec Configure ou Reconfigure.
  • Il devient actif lors de la prochaine actualisation. Un serveur nouvellement connecté peut mettre un instant avant d'être utilisé par l'agent.

Questions fréquentes

Combien de capacités sont incluses dans mon forfait ?

Il n'y a pas de nombre fixe. Les capacités incluses, comme l'extraction de pages web, les données SEO et la recherche web, sont gérées pour vous et cet ensemble peut changer : lisez donc les cartes Included sur votre propre page.

Dois-je ajouter un serveur ou chercher dans Discover ?

Cherchez d'abord dans Discover. N'ajoutez un serveur que si l'outil n'a pas d'entrée dans le catalogue et publie sa propre adresse MCP, et utilisez Custom API pour une API REST avec une clé.

Sydekick peut-il ajouter un serveur pour moi dans le chat ?

Pas d'après ce qui a été testé. Les identifiants et l'autorisation se gèrent sur cette page.

Suivant

Découvrez l'agent en action

Commencez votre essai gratuit. Annulez à tout moment.