> ## Documentation Index
> Fetch the complete documentation index at: https://docs.happycapy.ai/llms.txt
> Use this file to discover all available pages before exploring further.

# カスタムシークレット

> 外部ツールを使うための非公開アクセスキーを保存し、チャットで公開しないようにします。

カスタムシークレットは、GitHub、Notion、Fly.io、Stripe、社内ツールなど、Happycapy の外部サービスで使う非公開アクセスキーです。

ツールが token や API key を必要とする場合は、チャットに貼り付けるのではなく、**Settings > Sandbox > Custom secrets** に追加してください。Happycapy は各メッセージの実行時に、そのシークレットを環境変数としてサンドボックスへ注入します。

## カスタムシークレットを使う場面

Happycapy があなたの代わりにサービスやツールへアクセスする必要があるときに使います。

よくある例：

* GitHub リポジトリ、Pull Request、workflow run を確認する
* Notion ページを作成または更新する
* Fly.io などのプラットフォームでアプリをデプロイまたは確認する
* 自分の Stripe、分析、データベース、社内 API を呼び出すスクリプトを実行する
* 環境変数から認証情報を読む command-line tools を使う

## シークレットを追加する

1. **Settings** を開きます。
2. **Sandbox** に移動します。
3. **Custom secrets** を探します。
4. **Add** をクリックします。
5. **Key**、**Value**、**Description** を入力します。
6. **Create** をクリックします。

<Frame>
  <img src="https://mintcdn.com/happycapy/3Agk_CtGKKqauJRe/images/integrations/custom-secrets-settings.png?fit=max&auto=format&n=3Agk_CtGKKqauJRe&q=85&s=ee2a7b86e5ffb93a49b5ca42c0825528" alt="Happycapy の Sandbox 設定にある Custom secrets" width="2326" height="1508" data-path="images/integrations/custom-secrets-settings.png" />
</Frame>

## 各フィールドの意味

| フィールド           | 簡単な意味                              | 例                                                   |
| --------------- | ---------------------------------- | --------------------------------------------------- |
| **Key**         | Happycapy とツールがこのシークレットを見つけるための名前。 | `GITHUB_TOKEN`                                      |
| **Value**       | 実際の非公開 token、API key、またはシークレット値。   | GitHub、Notion、その他のサービスから取得した値を貼り付けます。               |
| **Description** | このシークレットの用途を Happycapy に伝える短い説明。   | `GitHub access for checking PRs and workflow runs.` |

Description は単なるラベルではなく、短い指示として書くのがおすすめです。

良い例：

```text theme={null}
GitHub token for using the gh CLI and GitHub API in my repositories.
```

曖昧な例：

```text theme={null}
github token
```

## よく使う例

| Key                  | 用途                                                       |
| -------------------- | -------------------------------------------------------- |
| `GITHUB_TOKEN`       | リポジトリの読み取り、Pull Request の確認、GitHub API の利用、または `gh` の実行。 |
| `NOTION_TOKEN`       | Notion API を使って Notion ページやデータベースを扱う。                    |
| `FLY_API_TOKEN`      | `flyctl` で Fly.io アプリをデプロイまたは確認する。                       |
| `STRIPE_API_KEY`     | 自分の Stripe アカウントを呼び出すスクリプトをテストする。                        |
| `INTERNAL_API_TOKEN` | スクリプトから社内 API やプロジェクト API を呼び出す。                         |

これらの名前は例です。使う予定のツール、SDK、CLI が期待する key 名を必ず使ってください。

## Happycapy がシークレットを使う仕組み

カスタムシークレットを追加したら、値をチャットに貼り付ける必要はありません。通常どおりタスクを依頼してください。

```text theme={null}
Use GitHub to check the latest failed workflow run and summarize what broke.
```

```text theme={null}
Use the Notion API to create a task list from this meeting summary.
```

Happycapy は環境変数が存在することを把握し、Description から用途を理解できます。シークレットの値は画面上では非表示のままです。

## Tips

非公開 token をチャットに直接貼り付けないでください。

できるだけ明確で標準的な key 名を使ってください。多くのツールは環境変数の正確な名前を探します。

Description は具体的に書いてください。サービス、ツール、想定用途を含めます。

不要になったシークレットは削除してください。

ツールがシークレットを見つけられない場合は、key 名がそのツールの期待する名前と一致しているか確認してください。

## 関連リソース

* [CLI ツール](/ja/integrations/cli)：環境変数から認証情報を読む command-line tools を使う。
* [MCP](/ja/integrations/mcp)：MCP サーバーを通じて Happycapy を外部ツールやシステムに接続する。
* [Files](/ja/features/files)：サンドボックス内のアップロードファイルと生成された出力を管理する。