開発者設定
個人キー、アプリクライアント、エージェントや CLI の接続：Sofia API ページの各操作と、どれを選ぶかを説明します。
このセクションは、プログラムで扱うものすべての入り口です。リファレンスは「API」「Agents」「アプリに Sofia を追加」の各タブにあり、このページでは画面上の操作を説明します。設定を開き、「Sofia API」セクションを選びます。
アクセス
ページには「個人アクセス」と「アプリクライアント」の 2 つのタブがあります。
個人キー
- キーを作成します。「新しいキー」で、任意の名前、有効期限（7 日、30 日、90 日、1 年、または無期限）、権限を設定します。初期状態ではすべてにチェックが入っています。ツールに必要なものだけを残してください。
- すぐにコピーします。 表示されるのは一度だけで、Sofia はそのフィンガープリントしか保管しません。
- 使います。 すべての呼び出しの
Authorization: Bearerヘッダーに入れて送ります。キーは、あなたの権限で、すべての店舗に対して動作します。
AI アシスタントを接続する
Claude、ChatGPT、Cursor、Gemini CLI、Claude Code には、接続済みアプリのコネクタのほうが簡単なことが多く、キーも不要です。AI コネクタをご覧ください。
CLI とエージェント
「エージェント用の指示をコピー」で、エージェントに貼り付けて API を使わせるテキストが得られます。npm で sofia-post として公開されている sofia コマンドは、API をラップしており、ターミナル、スクリプト、定期タスクから公開できます。インストール方法は「Agents」タブにあります。
アプリクライアント
アプリクライアントは、あなたとして動くものではなく、ほかの Sofia ユーザーが許可するものを作るために使います。
- クライアントを作成します。「新しいクライアント」で、名前、180 × 180 ピクセル以上のロゴ、プライバシーポリシーのアドレス、HTTPS のリダイレクト URL（1〜5 件）、アプリが要求できる権限を指定します。名前とロゴは、許可の際に利用者に表示されます。
- 認証情報をコピーします。 Client ID と Client Secret が発行されます。コードが公開されているアプリ向けの公開クライアントにはシークレットがなく、PKCE で認証します。この選択は変更できません。
- フローを実装します。「アプリに Sofia を追加」タブをご覧ください。
キーか OAuth クライアントか
| 項目 | 個人キー | アプリクライアント |
|---|---|---|
| 誰として動くか | あなた | 許可した本人 |
| 向いている用途 | 自分用のスクリプトや自動化 | ほかの Sofia ユーザーが使うプロダクト |
| 設定方法 | キーをコピーする | クライアントを登録し、フローを実装する |
| 取り消し方 | キーを「取り消す」 | 本人が「接続済みアプリ」でアクセスを解除するか、クライアントを削除する |
自分の投稿を自動化するなら、キーを使います。クライアントを作るのは、ほかの人のアカウントが関わる場合だけにしてください。
さらに詳しく
- API：エンドポイント、ペイロード、ネットワークごとの設定は、API タブにあります。
- CLI：ターミナルから公開する方法は、Agents タブにあります。
- AI コネクタ：Claude、Cursor、ChatGPT を接続します。AI コネクタをご覧ください。
この記事は役に立ちましたか？