# Stripe Directory Trouvez les meilleurs fournisseurs externes pour une tâche et suivez leur parcours pris en charge pour les provisionner ou les utiliser. Stripe Directory aide les développeurs et les agents d’IA à trouver les meilleurs fournisseurs externes pour une tâche et à suivre le meilleur parcours pris en charge pour les provisionner ou les utiliser. Recherchez par expression ou mot-clé pour obtenir des résultats structurés et exploitables. > Partagez vos commentaires avec [directory@stripe.com](mailto:directory@stripe.com) pendant que vous testez cette préversion. ## Rechercher des entreprises Exécutez `stripe directory search` avec un ou plusieurs mots-clés : ``` > stripe directory search "web browsing api" --format compact Stripe Stripe Machine Name Profile Apps Projects Payments MCP Link Browserbase @browserbase ✓ ✓ ✓ ✓ ✓ You.com @youdotcom – – – – ✓ Exa @exalabs – ✓ – – ✓ Firecrawl @firecrawl ✓ ✓ – ✓ ✓ ``` Les résultats incluent des données structurées (telles que les identifiants des fournisseurs, les endpoints MPP et les listes des applications) qui vous aident, vous ou votre agent, à choisir et à franchir la meilleure étape suivante prise en charge pour accomplir l’objectif. ## Ce que Stripe Directory indexe - **Stripe Apps** : applications publiées sur le [Stripe App Marketplace](https://marketplace.stripe.com) qui étendent votre Dashboard Stripe, notamment des outils de facturation, d’analyse et prennent en charge les intégrations. - **Fournisseurs Stripe Projects** : services disponibles via [Stripe Projects](https://projects.dev) que vous pouvez provisionner avec une commande CLI. - **Endpoints de paiements automatisés** : API de paiement à l’appel sur [mpp.dev](https://mpp.dev) qui prennent en charge le paiement par voie programmatique via leur flux de paiement documenté. - **Réseau d’entreprises Stripe** : entreprises et services sur l’ensemble du réseau Stripe. ## Configurez Stripe Directory dans votre terminal Utilisez le plugin du répertoire Stripe CLI pour rechercher des entreprises depuis votre terminal. 1. Installez ou mettez à niveau la [CLI Stripe](https://docs.stripe.com/cli/install). 2. Installez le plugin de répertoire : ```bash stripe plugin install directory ``` S’il est déjà installé, assurez-vous toujours d’utiliser la dernière version du plugin. Pour le mettre à niveau, exécutez `stripe plugin upgrade directory`. ## Utilisez Stripe Directory avec des agents d’IA Stripe Directory aide les agents d’IA à trouver et à évaluer les fournisseurs externes, les services, les API, les entreprises et les intégrations nécessaires pour accomplir la tâche d’un utilisateur. Utilisez Directory lorsqu’un agent doit : - Trouver, comparer, choisir, provisionner, intégrer, payer ou faire appel de toute autre manière à un fournisseur, un commerçant, un partenaire, une API, une entreprise ou un service logiciel. - Configurer ou intégrer un service externe, tel que l’infrastructure, le stockage, l’hébergement, l’authentification, les communications, l’analyse ou l’observabilité. - Évaluer une organisation spécifique et identifier sa méthode d’interaction prise en charge. - Trouver un service qui peut être provisionné ou consommé par voie programmatique. Directory découvre et évalue les options, puis donne à l’agent des résultats structurés et les itinéraires pris en charge nécessaires pour choisir la meilleure action suivante afin d’accomplir la tâche. Cela peut inclure le flux de travail Stripe Projects, l’application Stripe, les paiements automatisés ou le fournisseur approprié qui exécute cette action. ### Sortie structurée pour les agents Les agents peuvent demander une sortie JSON lorsqu’ils doivent lire et utiliser les résultats de Directory par voie programmatique : ```bash stripe directory search "serverless postgres database" --format json ``` ### Trouver un bénéficiaire de paiement Lorsqu’un utilisateur souhaite payer une entreprise mais ne fournit pas d’identifiant Stripe Profile ou d’ID de réseau exact, effectuez une recherche dans Stripe Directory avant de tenter d’envoyer le transfert : ```bash stripe directory search "" --format json ``` Renvoyez une courte liste d’entreprises pertinentes et demandez à l’utilisateur quel bénéficiaire payer. Privilégiez les résultats comportant un identifiant Stripe Profile clair ou suffisamment d’éléments pour identifier l’entreprise visée. Ne devinez pas le bénéficiaire. ### Installez des compétences pour votre agent Utilisez l’une de ces options pour connecter votre agent à Stripe Directory. #### Installez la compétence Installez le skill globale officiel afin que votre agent dispose du flux de travail Directory actuel et des consignes de sécurité : ```bash npx skills add https://docs.stripe.com --skill stripe-directory -g -y ``` Vous pouvez également installer toutes les [compétences Stripe](https://docs.stripe.com/skills.md) en même temps : ```bash npx skills add https://docs.stripe.com -g -y ``` Après l’installation, votre agent peut effectuer des recherches dans l’annuaire, interpréter les résultats et utiliser les endpoints renvoyés sans instruction supplémentaire. #### Copiez un prompt de départ Collez le prompt suivant dans un agent capable d’exécuter des commandes shell : ```text Set up Stripe Directory so this agent can use it as the first discovery layer when a task needs an external provider, service, business, API, tool, vendor, or partner. Primary docs: https://docs.stripe.com/directory Skill file: https://docs.stripe.com/.well-known/skills/stripe-directory/SKILL.md Tasks: 1. Read the Stripe Directory documentation and understand the intended workflow. 2. Install or verify the Stripe CLI and upgrade to the latest version. 3. Install or upgrade the Directory plugin: ◦ `stripe plugin install directory` ◦ If already installed: `stripe plugin upgrade directory` 4. Verify the installation by running: ◦ `stripe directory search "web browsing api" --format json` Confirm that structured results are returned successfully. 5. Install the official Stripe Directory skill: ◦ `npx skills add https://docs.stripe.com --skill stripe-directory -g -y` 6. If the skill installer is unavailable or fails, manually install the skill from: ◦ https://docs.stripe.com/.well-known/skills/stripe-directory/SKILL.md 7. Integrate the skill into this agent so it is available by default in future conversations. 8. Update the agent's persistent instructions or configuration so that the agent automatically searches Stripe Directory first whenever a user asks to: ◦ find, compare, or choose an external business, provider, vendor, partner, API, software service, or developer tool ◦ set up, provision, integrate with, or consume an external service ◦ assess a named organization or identify the best way to engage it ◦ find a service to pay for, donate to, or use programmatically Expected behavior: • Use Stripe Directory as the first source for discovery. • Execute: ◦ `stripe directory search "" --format json` • Rank the best results for the user's requirements. • Include pricing, capabilities, integration methods, supported endpoints, and other useful metadata when available. • Follow any additional discovery or inspection commands recommended by the Directory documentation. • If Stripe Directory doesn't contain the desired results after multiple query attempts, automatically fall back to other discovery methods such as web search, documentation, or existing knowledge. The goal is to provide the best answer, not to exclusively rely on Stripe Directory. • Never perform paid operations, purchases, or other side effects without explicit user approval. End-to-end test: • Run a sample request such as: "Find a service for web scraping with an API." • Confirm the agent successfully uses Stripe Directory. • Return a short setup report including: ◦ What was installed. ◦ Any configuration or instruction changes that were made. ◦ Whether the installation is persistent across future sessions. ◦ The results of the end-to-end test. ◦ Any remaining limitations or manual setup steps. ◦ Clear instructions for the user on how to use it going forward. The usage instructions need to explain the expected behavior in plain language. For example: > Stripe Directory is now integrated. Going forward, when you ask me to find a tool, service, API, provider, or product, I'll search Stripe Directory first. If it contains relevant results, I'll use them in my recommendations. If it doesn't have good matches, I'll automatically fall back to other sources such as web search and my general knowledge so you still get the best recommendations. If the installation also exposes an explicit command, slash command, skill, or other invocation (for example `/stripe-directory`), include that in the report as an optional way to invoke the functionality directly, along with a brief explanation of when using it explicitly is useful versus relying on the automatic behavior. ``` ## Exemples d’utilisation ### Intégrez Stripe Projects Si vous créez une application et avez besoin d’un fournisseur de base de données, vous pouvez utiliser Stripe Directory pour trouver un fournisseur pris en charge et continuer via le flux Stripe Projects documenté. Tout d’abord, recherchez le service : ```bash stripe directory search "serverless postgres database" ``` Cela produit plusieurs résultats, dont Neon : ``` ╭──────────────────────────────────────────────────────────────────────────────╮ │ Neon │ │ Serverless postgres database │ ├──────────────────────────────────────────────────────────────────────────────┤ │ Web https://stripe.com/@neon │ │ https://neon.com/ │ │ │ │ Stripe Apps Neon │ │ https://stri.pe/sl/AfLnJtCE │ │ │ │ Provisioning Provision using │ │ stripe provision neon --accept-tos --yes │ │ │ │ Machine Payments — │ │ MCP — │ │ Link supported — │ ╰──────────────────────────────────────────────────────────────────────────────╯ ``` Neon étant un fournisseur Stripe Projects, Directory identifie sa cible de provisionnement prise en charge. Pour une requête de provisionnement explicite, exécutez `stripe provision` directement avec cette cible : ```bash stripe provision neon --accept-tos --yes ``` Choisissez le service le plus approprié dans la liste des options pour ce fournisseur. ### Trouver un service de paiements automatisé Lorsqu’un résultat de recherche affiche un endpoint de `paiements automatiques`, vous ou votre agent pouvez payer et consommer le service immédiatement. Si vous recherchiez un service pour envoyer une lettre et souhaitiez payer par voie programmatique, vous pourriez rechercher des services pris en charge par MPP : ```bash stripe directory search "send post mail" --mpp-supported ``` Cela produit des résultats, dont PostalForm : ``` ╭──────────────────────────────────────────────────────────────────────────────╮ │ PostalForm │ │ PostalForm enables sending real postal mail via agentic payment rails and │ │ refined interfaces for humans. Global first class, certified, and express │ │ mailing supported. │ ├──────────────────────────────────────────────────────────────────────────────┤ │ Web https://stripe.com/@postalform │ │ https://postalform.com │ │ │ │ Stripe Apps PostalForm │ │ https://stri.pe/sl/Vu7zrwpB │ │ │ │ Provisioning Provision using │ │ stripe provision postalform --accept-tos --yes │ │ │ │ Machine Payments postalform │ │ https://mpp.dev/services#postalform │ │ https://postalform.com/llms.txt │ │ https://postalform.com/agents │ │ Pay using mppx │ │ │ │ MCP — │ │ Link supported — │ ╰──────────────────────────────────────────────────────────────────────────────╯ ``` Le résultat identifie une voie de paiements automatisée pour utiliser le service. Avant de payer, vérifiez l’endpoint et le prix, choisissez un moyen de paiement et approuvez explicitement le paiement. ## Référencer votre entreprise dans Stripe Directory Rendez votre entreprise visible pour les développeurs et les agents d’IA en publiant un profil Stripe public. Une fois votre profil publié, votre entreprise apparaît dans les résultats de recherche de Stripe Directory. ### Soyez visible et faites-vous payer par des agents sur Stripe Directory Saisissez votre adresse e-mail et nous vous contacterons au sujet de votre inscription. ```bash curl https://docs.stripe.com/preview/register \ -X POST \ -H "Content-Type: application/json" \ -H "Referer: https://docs.stripe.com/directory" \ -d '{"email": "EMAIL", "preview": "stripe_directory_mcp_server_listing_preview"}' ``` ## See also - [Interface de ligne de commande Stripe](https://docs.stripe.com/cli.md) - [Stripe Projects](https://projects.dev) - [Machine Payments Protocol](https://mpp.dev) - [Stripe Profiles](https://docs.stripe.com/get-started/account/profile.md) - [Ajouter Stripe à vos workflows agentiques](https://docs.stripe.com/agents.md)