APIキーとAI CLI
ワークスペースデータを1MarketingToolクラウドに送信せずに、ホスト型プロバイダー、ローカルAI CLI、MCPインテグレーションを接続します。
1MarketingToolはBYOK（Bring Your Own Key）方式です。接続するプロバイダーは自分で決定し、アプリは自分のAPIキーまたはローカルAI CLIを使用します。
サポートされているAI CLI
アプリは一般的なローカルAIコマンドラインツールと連携できます：
| CLI | 一般的な用途 |
|---|---|
| Claude Code CLI | 文章作成と分析タスク |
| Codex CLI | コーディング、コンテンツ、画像対応ワークフロー |
| Gemini CLI | コンテンツと画像対応ワークフロー |
| OpenCode CLI | 汎用ローカルエージェントワークフロー |
| Kiro CLI | 利用可能な場合のローカルエージェントワークフロー |
| Hermes | macOS・Windows・Linux でネイティブに検出。ワンショットモードでコンテンツ生成、Prompt Explorer の比較、その他ローカル AI 処理に利用でき、実行ごとにモデルを選択可能 |
実際に使用するCLIのみを有効にしてください。CLIがインストールされていない場合は、マシンで利用可能になるまで無効のままにしておきます。
ホスト型プロバイダー
ワークフローで外部データや特定のモデルが必要な場合はホスト型プロバイダーを使用します：
- 生成用のOpenAI、Claude、Gemini、または他のAIプロバイダー。
- キーワード、SERP、バックリンク、ランキングデータ用のDataForSEO。
- サイトパフォーマンス用のGoogle Search Consoleと分析サービス。
- 予約公開用のソーシャルチャネルAPI。
自分のマシン上のモデル
BYOKルートの接続先を、ホスト型サービスではなく、このコンピューターやローカルネットワーク上で動いているモデルにできます。LM Studio、Ollama、1LocalAIToolなど、OpenAI形式で応答するサーバーに対応しています。また、Anthropic形式で応答するサーバーにも対応しており、1LocalAIToolはこの形式にも対応しています。
- Settings → AI を開き、BYOK に切り替えます。
- Gatewaysで Custom OpenAI-compatible を選びます。サーバーがAnthropic形式の場合は、Protocolsで Anthropic を選びます。
- Base URL にローカルサーバーが表示するアドレス（LM Studioなら
http://localhost:1234/v1、Ollamaならhttp://localhost:11434/v1など）を入力し、Model にサーバーが提供するモデルIDを入力します。 - API key に何か入力します。この欄は空にできませんが、キーを検証しないローカルサーバーはどんな値でも受け付けます。
- Test connection をクリックし、続けて Use as active をクリックします。
CPUや小さなGPUで動くモデルは書くのに時間がかかるため、1MarketingToolはローカルのBase URLに最大10分の応答時間を与えます（ホスト型プロバイダーは45秒）。この長い制限が適用されるホストは localhost, 127.x, 10.x, 192.168.x, 172.16–31.x, .local, Tailscale (100.64–127.x, .ts.net) です。Custom OpenAI-compatibleには1.5.0から、Anthropicには1.5.1から適用されるため、遅いローカルモデルでも長いキャンペーンや記事が途中でタイムアウトせずに最後まで完了します。
キーの保存
APIキーとトークンはアプリ設定を通じて保存する必要があります。公開トークンはサポートされている場合はオペレーティングシステムのキーチェーンに保存されます。キャンペーンプロンプトやコンテンツフィールドにシークレットを貼り付けないでください。
MCPインテグレーション
1MarketingTool は rank、keyword、content、video、browser のツールを、onemarketingtool という単一のローカル MCP サーバー経由で公開します。対応する AI クライアントに自分のマシンからアプリ固有のワークフローを触らせたいときに使ってください — MCP インテグレーションを参照。
トラブルシューティング
プロバイダーが失敗した場合は、ログまたは関連する設定画面で正確なエラーを確認してください。ほとんどの失敗は、API権限の不足、トークンの期限切れ、またはシステムパスにないCLIが原因です。