# Stripe Directory

タスクに最適な外部プロバイダーを見つけ、サポートされている手順に沿ってプロビジョニングまたは利用します。

Stripe Directory を使用すると、開発者や AI エージェントは、タスクに最適な外部プロバイダーを見つけ、サポートされている最適な手順に沿ってプロビジョニングまたは利用できます。キーワードフレーズで検索して、整理された実行可能な結果を取得できます。

> このプレビューをテストする際は、[directory@stripe.com](mailto:directory@stripe.com) にフィードバックをお寄せください。

## 事業者を検索

1 つ以上のキーワードを使用して `stripe directory search` を実行します:

```
> 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     ✓           ✓            –            ✓            ✓
```

検索結果には、プロバイダースラッグ、MPP エンドポイント、アプリリストなどの構造化データが含まれます。これにより、目標を達成するためにサポートされている最適な次のステップを選択して実行できます。

## Stripe Directory のインデックス対象

- **Stripe Apps**: [Stripe App Marketplace](https://marketplace.stripe.com) で公開されているアプリ。請求ツール、分析ツール、サポート連携など、Stripe ダッシュボードを拡張します。
- **Stripe Projects のプロバイダー**: [Stripe Projects](https://projects.dev) を通じて利用できるサービスで、CLI コマンドを使用してプロビジョニングできます。
- **機械決済エンドポイント**: [mpp.dev](https://mpp.dev) 上の、呼び出し単位で課金される API です。ドキュメント化された決済ワークフローを介したプログラムによる決済に対応しています。
- **Stripe ビジネスネットワーク**: Stripe ネットワーク全体にわたるビジネスとサービス。

## 端末で Stripe Directory を設定

Stripe CLI Directory プラグインを使用して、端末からビジネスを検索します。

1. [Stripe CLI](https://docs.stripe.com/cli/install) をインストールまたはアップグレードします。

2. 次の手順で Directory プラグインをインストールします。

   ```bash
   stripe plugin install directory
   ```

すでにインストールされている場合は、毎回、最新バージョンのプラグインを実行していることを確認してください。アップグレードするには `stripe plugin upgrade directory` を実行します。

## AI エージェントでの Stripe Directory の使用

Stripe Directory により、AI エージェントはユーザーのタスクを完了するために必要な外部のプロバイダー、サービス、API、ビジネス、システム連携を見つけて評価できます。

エージェントが以下を行う必要がある場合は Directory を使用します。

- プロバイダー、ベンダー、パートナー、API、ビジネス、ソフトウェアサービスを検索、比較、選択、プロビジョニングしたり、それらと連携したり、料金を支払ったり、その他の方法で利用する。
- インフラストラクチャ、ストレージ、ホスティング、認証、通信、分析、オブザーバビリティなどの外部サービスを設定または連携する。
- 特定の組織を評価し、対応している利用方法を特定する。
- プログラムでプロビジョニングまたは利用できるサービスを見つける。

Directory により選択肢が検出・評価され、タスクの完了に最適な次のアクションを選択する際に必要な構造化結果と、サポートされているルートがエージェントに提供されます。これには、そのアクションに適した Stripe Projects、Stripe アプリ、機械決済、プロバイダーワークフローが含まれる場合があります。

### エージェント向けの構造化された出力

プログラムで Directory の結果を読み取り、アクションを実行する必要がある場合、エージェントは JSON 出力をリクエストできます。

```bash
stripe directory search "serverless postgres database" --format json
```

### 支払先を検索する

ユーザーがビジネスへの支払いを希望しているものの、正確な Stripe プロフィールのハンドルやネットワーク ID を提供していない場合は、送金を試行する前に Stripe Directory を検索します。

```bash
stripe directory search "<query>" --format json
```

関連するビジネスの短いリストを返し、どの支払先に支払うかをユーザーに確認します。明確な Stripe プロフィールのハンドルがある結果、または目的のビジネスを特定するための十分な証拠がある結果を優先します。支払先を推測しないようにします。

### エージェント用のスキルをインストールする

エージェントを Stripe Directory に接続するには、これらのオプションのいずれかを使用します。

#### スキルをインストール

エージェントが現在の Directory ワークフローと安全ガイダンスを利用できるように、公式のグローバルスキルをインストールします。

```bash
npx skills add https://docs.stripe.com --skill stripe-directory -g -y
```

あるいは、すべての [Stripe スキル](https://docs.stripe.com/skills.md)を同時にインストールします。

```bash
npx skills add https://docs.stripe.com -g -y
```

インストール後、エージェントはディレクトリを検索し、結果を解釈し、追加の指示なしで返されたエンドポイントを使用できます。

#### スタータープロンプトをコピーする

シェルコマンドを実行できるエージェントに次のプロンプトを貼り付けます。

```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 "<user query>" --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.
```

## 使用例

### Stripe Projects と連携

アプリケーションを構築していてデータベースプロバイダーが必要な場合は、Stripe Directory を使用してサポートされているプロバイダーを見つけ、ドキュメント化された Stripe Projects フローに沿って続行できます。

まずサービスを検索します。

```bash
stripe directory search "serverless postgres database"
```

これによりいくつかの結果が生成され、そのうちの 1 つが 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 は Stripe Projects プロバイダーであるため、Directory でサポートされているプロビジョニングターゲットが特定されます。明示的にプロビジョニングをリクエストされた場合は、そのターゲットを指定して `stripe provision` を直接実行します。

```bash
stripe provision neon --accept-tos --yes
```

そのプロバイダーの選択肢のリストから、最も適切なサービスを選択します。

### 機械決済サービスを検索

検索結果に `Machine Payments` エンドポイントが表示された場合、すぐに支払い、サービスを利用できます。

手紙を送るためのサービスを探しており、プログラムで支払いたい場合は、MPP 対応のサービスを検索できます。

```bash
stripe directory search "send post mail" --mpp-supported
```

これにより結果が生成され、そのうちの 1 つが 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 <endpoint>                                  │
│                                                                              │
│ MCP               —                                                          │
│ Link supported    —                                                          │
╰──────────────────────────────────────────────────────────────────────────────╯
```

検索結果から、サービスを利用するためのマシン決済ルートを特定できます。支払いの前に、エンドポイントと価格を確認し、決済手段を選択して、支払いを承認します。

## Stripe Directory に自社を掲載

公開 Stripe プロフィールを掲載することで、開発者や AI エージェントがビジネスを見つけられるようにします。プロフィールを公開すると、Stripe Directory の検索結果に会社が表示されるようになります。

### Stripe Directory でエージェントに見つけてもらい、決済を受け付けられるようにする

メールアドレスを入力してください。掲載手続きについてご連絡いたします。

```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

- [Stripe CLI](https://docs.stripe.com/cli.md)
- [Stripe Projects](https://projects.dev)
- [Machine Payments Protocol](https://mpp.dev)
- [Stripe プロフィール](https://docs.stripe.com/get-started/account/profile.md)
- [エージェントワークフローに Stripe を追加](https://docs.stripe.com/agents.md)