ConnexionCommencer

Intégration officielle YieldCove

Vos finances. Votre contexte.L’agent de votre choix.

Connectez Hermes, Codex ou Claude Code à vos finances. Posez vos questions sur votre portefeuille et vos dépenses, ou autorisez votre agent à enregistrer vos opérations, revenus et dépenses.

HermesCodexClaude CodeMCP
  • Choisissez lecture ou lecture + saisie par espace
  • Examinez vos finances et enregistrez des opérations avec votre agent
  • Déconnectez votre agent dans les paramètres à tout moment
Connecter mon agentSuivre le guide visuel

Inclus avec votre compte YieldCove gratuit. Votre agent peut nécessiter un abonnement distinct.

Votre YieldCoveLecture seule
Vous

Aide-moi à comprendre la répartition de mon portefeuille.

Lecture de votre espace connecté

Les positions de cet exemple se concentrent sur deux fonds. Je peux comparer leur prix de revient et les dividendes, en séparant les CAD et les USD.

Répartition enregistréeCAD

VFV.TO70%

XEQT.TO30%

Coût de base enregistré4 000,00 CAD
D’après les positions et les dividendes

Conversation illustrative · données fictives

La version courte

Trois étapes. Puis posez vos questions.

Il vous faut un compte YieldCove avec des données et un agent installé qui accepte MCP distant avec authentification par jeton Bearer. Aucune clé de modèle IA n’est nécessaire dans YieldCove.

  1. 01

    Choisissez les données

    Ouvrez Paramètres → Agents. Choisissez les espaces lisibles et activez la saisie au besoin. Créez une clé personnelle.

    Wheel ✓ Invest ✓ Budget ✓
  2. 02

    Connectez une fois

    Conservez la clé en privé. Copiez la configuration dans votre agent, puis redémarrez-le.

    YieldCove → connexion sécurisée → Agent
  3. 03

    Posez votre question

    Essayez le premier exemple. Votre agent consulte les outils autorisés et vous explique ce qu’il trouve.

    « Fais mon bilan financier de la semaine. »
Connecter mon agent

Pour l’agent que vous utilisez.

Commencez avec Hermes ou choisissez un autre client compatible. Les configurations utilisent une variable d’environnement, jamais votre clé réelle. Ajoutez l’entrée à votre configuration existante en conservant vos autres serveurs.

Enregistrez YIELDCOVE_API_KEY=votre-clé dans votre fichier privé ~/.hermes/.env. Ajoutez la configuration ci-dessous à ~/.hermes/config.yaml, sous la section mcp_servers si elle existe déjà. Redémarrez Hermes pour découvrir les outils YieldCove.

~/.hermes/config.yaml
mcp_servers:
  yieldcove:
    url: "https://yieldcove.com/api/integrations/mcp"
    headers:
      Authorization: "Bearer ${YIELDCOVE_API_KEY}"

Remplacez « votre-clé » par la clé des paramètres. Gardez-la dans un environnement privé ou un gestionnaire de secrets, jamais dans une conversation, un dépôt de code, une capture ou une configuration partagée. Les fichiers téléchargés ne contiennent pas votre clé.

Documentation de l’agent

Moins de configuration. Des questions utiles.

Copiez un exemple dans votre agent connecté. Activez d’abord l’espace correspondant. Les réponses dépendent de vos données enregistrées.

Wheel
Utilise YieldCove pour examiner mes positions wheel ouvertes et ma liste de suivi. Regroupe les prochaines échéances, affiche les primes enregistrées et signale les informations manquantes. Ne passe aucun ordre.
Invest
Utilise YieldCove pour résumer mes positions, leur prix de revient et les dividendes enregistrés cette année. Sépare les devises, repère les concentrations et distingue les valeurs enregistrées des cours du marché.
Budget
Utilise YieldCove pour examiner mes dépenses du mois et les prochaines factures récurrentes. Parcours toutes les pages de transactions pertinentes, précise les devises et propose trois points à examiner. Ne modifie pas mes données.

Confiez aussi la saisie à votre agent.

La lecture est activée par défaut. Chaque espace possède sa permission d’écriture facultative. Wheel enregistre les CSP et calls couverts ; Invest, les achats et ventes dans des comptes existants ; Budget, les revenus et dépenses. Ces outils ajoutent des données au suivi, sans passer d’ordres ni effectuer de paiements.

  1. 01

    Autorisez le nécessaire

    Dans Paramètres → Agents, cochez l’espace et sa permission de saisie. Pour une clé existante, créez un remplacement avec les nouvelles permissions, puis révoquez l’ancienne.

  2. 02

    Donnez les vrais détails

    Précisez le compte, la date, le symbole et les montants. Pour Wheel, la prime est par action, la quantité en contrats et la commission d’ouverture totale. Invest utilise les actions et la devise du compte ; Budget utilise des montants signés.

  3. 03

    Vérifiez l’enregistrement

    Votre agent reçoit l’identifiant du nouvel enregistrement. Ouvrez l’espace correspondant pour le vérifier ou le corriger. Un UUID évite les doublons lors des nouvelles tentatives ; utilisez un nouvel UUID seulement pour une autre transaction.

Commencer une saisie
Je souhaite enregistrer dans YieldCove une opération que j’ai déjà effectuée. Vérifie d’abord la permission de saisie dans le bon espace. Demande-moi tout détail manquant : compte, date, symbole, prix, prime, quantité ou frais. Résume l’opération avant de l’enregistrer ; utilise un UUID de requête et conserve-le pour toute nouvelle tentative. Ne passe jamais d’ordre de courtage.

Les données accessibles à votre agent

Seuls les outils autorisés par la clé sont exposés. MCP et REST appliquent les mêmes permissions. La saisie exige confirmed: true et un request_id unique (UUID). L’agent doit demander les détails manquants et réutiliser le même UUID et les mêmes paramètres lors d’une nouvelle tentative. Aucun accès à l’API opérateur, au Control Center ou à la publication.

Wheel

  • list_positions

    Positions sur options ; filtres facultatifs par statut et symbole.

  • list_watchlist

    Symboles suivis, étiquettes et notes.

  • log_wheel_trade

    Ajouter un CSP ou call couvert déjà exécuté au suivi wheel. Permission d’écriture facultative requise.

Invest

  • invest_list_accounts

    Comptes et liquidités calculées depuis le registre.

  • invest_list_holdings

    Positions et prix de revient enregistrés.

  • invest_portfolio_summary

    Synthèse du portefeuille par devise.

  • invest_dividend_summary

    Dividendes enregistrés pour une année donnée.

  • log_invest_trade

    Saisir un achat ou une vente dans un compte Invest existant. Permission d’écriture facultative requise.

Budget

  • budget_overview

    Flux mensuels, budget et prochaines factures.

  • budget_list_accounts

    Comptes Budget et soldes enregistrés.

  • budget_list_transactions

    Dépenses et revenus paginés avec filtres de dates.

  • budget_list_recurring

    Factures récurrentes et occurrences non enregistrées.

  • budget_list_goals

    Objectifs d’épargne et progression.

  • log_budget_transaction

    Saisir un revenu ou une dépense dans un compte Budget existant. Permission d’écriture facultative requise.

Pour les agents personnalisés : référence REST

Envoyez votre clé dans l’en-tête Authorization: Bearer. GET vérifie la connexion et renvoie les outils autorisés avec leurs schémas JSON. POST appelle un outil. Utilisez un client HTTPS ; les clients uniquement dans un navigateur sur une autre origine ne sont pas pris en charge.

Tester la clé
curl --fail-with-body 'https://yieldcove.com/api/integrations/agent' \
  -H "Authorization: Bearer $YIELDCOVE_API_KEY"
Exemple : une page de transactions Budget
curl --fail-with-body 'https://yieldcove.com/api/integrations/agent' \
  -H "Authorization: Bearer $YIELDCOVE_API_KEY" \
  -H 'Content-Type: application/json' \
  -d '{"action":"budget_list_transactions","parameters":{"limit":25,"offset":0}}'

POST accepte {action, parameters} et renvoie {ok: true, data}. Les paramètres sont validés ; les champs inconnus sont refusés. Le manifeste GET fournit les schémas exacts. Erreurs : 400 paramètres invalides, 401 clé invalide/expirée/révoquée, 403 outil interdit, 404 donnée introuvable, 413 requête trop volumineuse, 429 limite de requêtes, 503 indisponibilité. Limites : 60 requêtes par minute et par clé, corps de 16 Ko. Respectez Retry-After en cas de 429. Les transactions acceptent limit (1–200) et offset ; les positions renvoient au plus les 500 entrées les plus récentes. Une saisie renvoie l’identifiant et le champ replayed. Générez un UUID request_id par transaction réelle ; conservez-le pour toute nouvelle tentative. Sa réutilisation avec des détails différents renvoie 409 request_id_conflict. Consultez l’enregistrement dans l’app avec son identifiant.

Un contexte utile. Des limites claires.

Choisissez lecture seule ou lecture avec saisie par espace. La saisie ajoute des opérations wheel, achats/ventes Invest et revenus/dépenses Budget. Elle ne peut ni modifier ou supprimer les données existantes, ni passer d’ordres, payer des factures, synchroniser les banques ou publier du contenu. Corrigez les données dans l’app. Les avertissements du registre, devises et informations manquantes restent pertinents.

Vous choisissez l’accès

Chaque clé appartient à un compte. Les permissions de lecture et saisie sont choisies par espace ; les anciennes clés restent en lecture seule. Créez un remplacement pour changer l’accès. Expiration après 30 ou 90 jours.

Sachez où vont vos données

Votre fournisseur d’agent reçoit les données demandées selon sa politique de confidentialité. YieldCove conserve une empreinte de clé, les métadonnées et des reçus de saisie (action, identifiant et empreinte de requête), jamais la clé brute ni les conversations.

Un arrêt à portée de main

Révoquez une connexion dans Paramètres → Agents pour bloquer les requêtes suivantes, y compris les clients MCP déjà connectés. Cela n’efface pas les données déjà reçues et n’annule pas une requête en cours.

Un peu d’aide au besoin.

Le test échoue ou je reçois une erreur 401.

Vérifiez les espaces superflus, l’expiration ou la révocation. La clé commence par yc_live_. Définissez YIELDCOVE_API_KEY dans l’environnement réellement utilisé par l’agent. Si vous avez perdu la clé, créez une connexion puis révoquez l’ancienne.

Mon agent est connecté mais ne voit pas un espace.

Vérifiez les espaces et permissions de saisie de la clé dans les paramètres. Pour ajouter un accès, créez une clé de remplacement, mettez à jour les identifiants privés de l’agent et redémarrez-le. Les clés existantes ne gagnent jamais automatiquement le droit d’écrire.

La réponse est vide ou inattendue.

Vérifiez le compte YieldCove utilisé pour créer la clé et la présence de données. Demandez à l’agent de vérifier les dates, comptes archivés, devises et pages de transactions. Le prix de revient enregistré n’est pas une valorisation en temps réel.

Puis-je utiliser n’importe quel chatbot ?

L’agent doit accepter MCP distant avec authentification Bearer personnalisée, ou appeler une API REST authentifiée. Des exemples pour Hermes, Codex et Claude Code figurent ci-dessus. Les interfaces limitées à OAuth ne peuvent pas utiliser ces clés personnelles. YieldCove ne fournit pas d’abonnement à un modèle IA.

Comment renouveler ou supprimer une connexion ?

Créez une clé, mettez à jour les identifiants privés de l’agent et vérifiez-la, puis révoquez l’ancienne dans les paramètres. Révoquez immédiatement toute clé exposée. Utilisez une clé distincte par agent pour les déconnecter séparément.

« Officielle » signifie développée et maintenue par YieldCove. La compatibilité n’implique ni approbation, ni présence sur une place de marché, ni partenariat avec Nous Research, OpenAI ou Anthropic.