Aller au contenu

Connecter un assistant d’IA

Chaque application a un serveur MCP : une adresse à laquelle un assistant d’IA se connecte pour utiliser l’application à votre place. Avec Invoicing connecté, vous pouvez demander des choses comme « Sur quoi ai-je travaillé la semaine dernière ? », « Saisis trois heures sur le relevé d’Ashgrove pour hier » ou « Prépare une facture pour le travail d’octobre d’Ashgrove ».

L’assistant agit en votre nom : il voit ce que vous voyez et, si vous l’autorisez à modifier des éléments, ne fait que ce que vous pourriez faire vous-même.

  • Un siège dans l’application, avec un forfait qui inclut l’accès à l’API. Accès à l’API indique ce qui manque, le cas échéant.
  • L’adresse du serveur MCP de l’application. Elle se trouve sur l’écran MCP (Paramètres du compte, puis MCP, sous Intégrations), avec la commande Claude Code prête à copier, et sur l’écran Accès à l’API. Pour Invoicing, c’est l’adresse de l’API de l’application suivie de /mcp, par exemple https://invoicing-api.eddish.app/mcp.

Il y a deux façons de se connecter. Se connecter depuis votre navigateur est la plus simple, et fonctionne avec la plupart des assistants. Un jeton d’accès personnel sert aux assistants qui ne peuvent pas ouvrir de navigateur.

Utilisez cette méthode pour claude.ai, les applications Claude, ChatGPT, VS Code et Claude Code.

  1. Dans l’assistant, ajoutez un connecteur (parfois appelé connecteur personnalisé ou serveur MCP) avec l’adresse du serveur MCP.
  2. L’assistant ouvre une page Eddish. Connectez-vous si nécessaire.
  3. Eddish vous demande de confirmer : quel compte, si vous êtes dans plusieurs, et si l’assistant peut seulement lire, ou aussi modifier des éléments. Choisissez Autoriser.
  4. Vous êtes renvoyé vers l’assistant, connecté.

La page affiche le nom que l’assistant s’est donné et l’adresse vers laquelle il vous renverra. N’importe qui peut appeler une application « Claude » : ne choisissez donc Autoriser que si vous avez lancé cette démarche vous-même, depuis l’assistant nommé.

Nous vous envoyons un e-mail à chaque connexion d’un assistant. Si ce n’était pas vous, déconnectez-le et changez votre mot de passe.

Fenêtre de terminal
claude mcp add --transport http invoicing https://invoicing-api.eddish.app/mcp

Lancez ensuite Claude Code, saisissez /mcp, choisissez invoicing puis Authenticate. Votre navigateur ouvre la page Eddish.

Pour un assistant qui se connecte à un serveur MCP avec un en-tête Authorization. Créez un jeton d’accès personnel pour l’application, en choisissant Lecture seule si l’assistant n’a besoin que de répondre à des questions. L’écran affiche une commande Claude Code prête à coller, ou ajoutez un serveur MCP avec :

  • Type : HTTP (parfois appelé Streamable HTTP)
  • URL : l’adresse du serveur MCP de l’écran Accès à l’API
  • En-tête : Authorization: Bearer <your token>

Avec Lecture seule, seuls les outils de lecture sont proposés. Avec Lecture et écriture, tous le sont.

Lectures Écritures (Lecture et écriture uniquement)
Qui vous êtes, et votre équipe Ajouter un client ou un projet
Clients, projets et leurs tâches Saisir du temps, démarrer et arrêter votre minuteur, supprimer une saisie de temps
Saisies de temps et votre minuteur en cours Ajouter une dépense
Dépenses et catégories de dépenses Préparer une facture à partir du travail non facturé (elle reste un brouillon)
Factures, et travail non facturé de chaque client Enregistrer un paiement sur une facture

Il ne peut pas envoyer de factures, modifier les taux ou les paramètres, ni gérer les personnes.

Tout ce qu’il ne peut pas faire à cause de votre rôle, d’une limite du forfait ou d’un siège manquant est refusé exactement comme dans l’application, et l’assistant en est informé.

Dans Accès à l’API, choisissez Déconnecter pour un assistant sous Applications connectées, ou révoquez son jeton. Il perd l’accès à sa requête suivante. Un Propriétaire ou un Administrateur peut déconnecter celui de n’importe qui dans Clés d’API, et quitter le compte déconnecte tous les vôtres.

Un assistant connecté le reste tant qu’il est utilisé. Un assistant non utilisé pendant 90 jours doit être reconnecté.