開発者設定

このセクションは、プログラムで扱うものすべての入り口です。リファレンスは「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 クライアントか

自分の投稿を自動化するなら、キーを使います。クライアントを作るのは、ほかの人のアカウントが関わる場合だけにしてください。

さらに詳しく

• API：エンドポイント、ペイロード、ネットワークごとの設定は、API タブにあります。
• CLI：ターミナルから公開する方法は、Agents タブにあります。
• AI コネクタ：Claude、Cursor、ChatGPT を接続します。AI コネクタをご覧ください。