ドキュメント

実際の使い方

新しいチームが初日に必要とする3つのことです。ここに書かれているのは、すべて今日出荷されている製品の説明です。

エージェントとは何か、どう頼むか

エージェントは、ひとつのオブジェクトに対して書かれた TypeScript です。自分で書く必要はありません。仕事をチャットで説明すれば Naski が書き、保存する前にコードを見せます。

1
何をいつ行うかを伝えます。「平日の毎朝8時」「PDF がフォルダに届いたら」「このアドレスにメールが来たら」。スケジュールとトリガーはコードを実行せずに読み取るため、固定の値として書かれます。
2
保存する前に、何をするのかを読みます。コードが振る舞いそのもので、その裏に隠れているものはありません。
3
スペースの一部だけを見せたい場合は、フォルダを与えます。ファイル操作は、そのサブツリーに限定されます。
4
作業記録を残させます。エージェントは行ったことを1件につき平易な1行で、進行中または完了の印をつけて書き、次の実行で読み返します。長い仕事が短い実行に分かれても続くのは、そのためです。
5
自分を通すべきことを決めます。承認を求めると、人が答えるまで実行が止まり、沈黙は拒否として扱われます。レビューに回すと、実行を止めずに項目が後回しの列に入ります。
6
エージェントを編集すると新しいエージェントができるので、動いていたバージョンは取り戻せます。

知っておくとよいことエージェントには、周囲のネットワークへのアクセスがありません。ウェブも、あなたのスペースも、接続したツールも、届く先はすべて、プラットフォームが代わりに実行する名前つきの呼び出しを通ります。

コネクタはコードではなくデータです。ベースアドレス、認証の形、操作の一覧。Naski がリクエストを組み立て、認証情報をサーバー側で注入します。

1
設定 → コネクタを開き、カタログからインストールします。チャットに頼んで入れてもらうこともできます。
2
提供元がお使いの環境に登録されている場合は、「接続」を押して提供元の画面で承認します。鍵はどこにもコピーされません。
3
そうでない場合は、設定に鍵を貼り付けます。チャットのメッセージに鍵を貼らないでください。鍵は設定にあるべきもので、そこで暗号化して保存され、サーバー側で注入されます。
4
サービスによっては自社のアドレスにあります — Salesforce、Zendesk、Jira、Confluence、Zoho CRM、Odoo、Shopify、DocuSign。これらのインストールではインスタンスの URL を尋ね、なければ受け付けません。
5
外向きの通信は HTTPS のみで、アドレスがプライベートまたは予約済みのネットワークに解決される場合は拒否されます。
6
提供元がトークンの更新を拒否した場合は、接続が解除され、再接続するよう伝えられます。すべての呼び出しが黙って失敗し続けることはありません。

知っておくとよいことカタログにないサービスにも届きます。チャットが同じ宣言的な形でコネクタを書けますし、リモートの MCP サーバーがツール型のサービスを担います。

Naski は自身の MCP サーバーを公開しています。Claude Code、Claude Desktop、ChatGPT といったクライアントから、いつも働いている場所で、エージェントの一覧・作成・実行・確認ができます。

1
設定 → MCP サーバーを開きます。エンドポイントはそこに表示され、次のとおりです:
```
https://api.blackbox.finance/mcp
```
2
Claude Desktop と ChatGPT は OAuth で接続します。エンドポイントをコネクタとして追加し、承認してください。コピーするトークンはありません。
3
コマンドラインのクライアントの場合は、設定でトークンを生成して次を実行します:
```
claude mcp add --transport http naski https://api.blackbox.finance/mcp --header "Authorization: Bearer YOUR_TOKEN"
```
4
トークンは一度だけ表示され、ハッシュとしてのみ保存されます。同じ画面から失効させられます。1つのアカウントで最大20件まで持てます。
5
外部 AI 接続は有料プランに含まれます。無料プランには含まれません。

知っておくとよいことMCP クライアントに見えるのは、使っているトークンのアカウントの範囲に限られます。そのアカウントのエージェント、実行、クレジットだけで、それ以外はありません。

無料プランには、有効なエージェント1つと定期実行1つが含まれます。誰かが何かに署名する前に、形が合うかどうかを見るには十分です。