Odiseo

Odiseo CLI

1 つのコマンドで、Codex、Claude Code、Cursor、または OpenClaw を Odiseo SEO MCP に接続できます。

Odiseo を使うと、エージェントはサイトの調査、ブリーフやコンテンツ計画の作成、記事の作成とレビュー、そして許可した組織内での公開ワークフローの実行に必要なツールを利用できます。

要件

• Node.js 20 以降
• MCP アクセスがある組織の Odiseo アカウント
• 対応クライアントのいずれか 1 つ：Codex、Claude Code、Cursor、または OpenClaw

クイックスタート

OAuth デバイスフローを使って、ブラウザーで認証します。

npx odiseo-cli login

次に、Odiseo をクライアントにインストールします。

npx odiseo-cli mcp install cursor

cursor を codex、claude、または openclaw に置き換えてください。最後に、認証情報と MCP エンドポイントを確認します。

npx odiseo-cli mcp doctor

ログインコマンドを実行すると、短いコードが表示され、Odiseo の承認ページが開きます。作成されたセッションは、所有者のみがアクセスできる権限で ~/.config/odiseo/config.json に保存されます。インストールコマンドは、そのベアラー認証情報を選択したクライアントのユーザーレベルの MCP 設定に追加します。

コマンド

odiseo login

OAuth デバイス認証フローを開始します。

odiseo login
odiseo login --no-open

ローカル開発の場合：

odiseo login --base-url http://localhost:3000 --no-open

上級ユーザーは、既存の Odiseo MCP API キーを使って認証することもできます。

odiseo login --key seoap_your_key

API キーは、サイト単位およびより限定的な権限セットに範囲を絞ることができます。ブラウザー OAuth とデバイス認証では、組織のメンバーシップ全体が適用されます。

odiseo mcp install

認証済みの Streamable HTTP サーバー定義をインストールします。

odiseo mcp install codex
odiseo mcp install claude
odiseo mcp install cursor
odiseo mcp install openclaw

デフォルトのエンドポイントは https://odiseo.help/api/mcp です。ローカル環境またはセルフホスト環境では、次のように変更できます。

odiseo mcp install cursor --endpoint http://localhost:3000/api/mcp

クライアントごとの動作：

クライアント	インストール方法
Cursor	odiseo を ~/.cursor/mcp.json にマージします
Codex	~/.codex/config.toml 内の [mcp_servers.odiseo] のみを置き換えます
Claude Code	ユーザースコープで claude mcp add を実行します
OpenClaw	Streamable HTTP トランスポートで openclaw mcp set を実行します

Cursor と Codex の設定ファイルは、モード 0600 でアトミックに書き込まれます。Claude Code と OpenClaw は、それぞれの設定ストアを管理し、保護します。

odiseo mcp doctor

保存済みの認証情報を使って、実際の MCP initialize リクエストを送信します。

odiseo mcp doctor
odiseo doctor

MCP サーバー名、プロトコルバージョン、レイテンシーを報告します。また、認証情報の期限切れ、サブスクリプションアクセスの不足、HTTP 認証の失敗について、具体的な対処方法も提示します。

odiseo logout

この CLI が保存した認証情報を削除します。クライアント設定はそのまま残るため、無関係な設定を失うことなく、odiseo login と odiseo mcp install <client> を再実行できます。

CLI を使わずに接続する

対応するすべてのクライアントは、Odiseo のネイティブ MCP OAuth ディスカバリーも利用できます。この URL のみを追加してください。

https://odiseo.help/api/mcp

例：

codex mcp add odiseo --url https://odiseo.help/api/mcp
codex mcp login odiseo

claude mcp add --transport http odiseo https://odiseo.help/api/mcp

openclaw mcp set odiseo \
  '{"url":"https://odiseo.help/api/mcp","transport":"streamable-http","auth":"oauth"}'
openclaw mcp login odiseo

Cursor ユーザーは、odiseo.help/mcp の Add to Cursor ボタンを使用できます。

セキュリティ

• CLI は保存済みのベアラートークンを表示しません。
• ファイルはアトミックに書き込まれ、対応している場合は所有者のみがアクセスできる権限が設定されます。
• 子プロセスはシェルを介さず、直接起動されます。
• OAuth／デバイス認証情報は、認証された組織へのアクセスを許可します。
• 公開および承認ツールは引き続き影響の大きい操作です。エージェントは、ユーザーから明示的な指示があった場合にのみ呼び出してください。
• より限定的な長期認証情報が望ましい場合は、サイトスコープの seoap_ API キーを使用してください。

認証情報が漏えいした場合は、Odiseo で取り消し、odiseo login を再実行してください。

開発

npm install
npm run typecheck
npm test

ビルド出力は dist/ に生成されます。このパッケージには実行時依存関係がありません。

ライセンス

MIT