ドキュメント

MCP 接続ガイド

機能

Submify は MCP(Model Context Protocol)サーバーを提供しています。接続すると、Codex、Claude Code、Cursor など MCP 対応の AI ツールから次の操作を行えます。

  1. サイトの作成とサイト情報の更新。
  2. タグ、おすすめパック、カテゴリでバックリンクをサイトの投稿キューに追加。
  3. URL またはバックリンク ID でバックリンクを一括追加。
  4. サイトの Codex 自動投稿プロンプトを生成。
  5. サイトごとの投稿進捗を確認。
  6. アカウント内の全サイトのバックリンク投稿状況を確認。

事前準備

  1. API キー管理 で API キー(sk_ で始まる)を作成し、有効にします。
  2. リモート MCP(Streamable HTTP)に対応した AI ツール(Codex、Claude Code、Cursor など)。

MCP エンドポイント:

https://submify.app/api/mcp

すべてのリクエストに Authorization: Bearer <API キー> ヘッダーが必要です。API キーはアカウントの認証情報です。公開せず、漏えいの疑いがある場合はすぐに無効化して再作成してください。

1. Codex に接続

~/.codex/config.toml に次を追加します。

[mcp_servers.submify]
url = "https://submify.app/api/mcp"
bearer_token_env_var = "SUBMIFY_API_KEY"

Codex を起動するターミナルで環境変数を設定します。

export SUBMIFY_API_KEY="sk_xxx"

2. Claude Code に接続

次のコマンドを実行します。

claude mcp add --transport http submify https://submify.app/api/mcp \
  --header "Authorization: Bearer sk_xxx"

3. Cursor などのツールに接続

ツールの MCP 設定ファイル(Cursor の場合は ~/.cursor/mcp.json)に次を追加します。

{
  "mcpServers": {
    "submify": {
      "url": "https://submify.app/api/mcp",
      "headers": {
        "Authorization": "Bearer sk_xxx"
      }
    }
  }
}

ツールを再起動し、MCP 一覧に submify と下記のツールが表示されれば接続完了です。

4. 利用できるツール

ツール用途
list_websitesアカウント内の全サイトとサイト数の上限を表示
get_websiteサイトの詳細情報と入力チェック結果を表示
create_websiteサイトを作成(product_name、product_url は必須)
update_websiteサイト情報を更新(変更する項目のみ指定)
add_backlinks_by_tagsタグ、おすすめパック、カテゴリでバックリンクを追加
batch_add_backlinksURL またはバックリンク ID で一括追加(1 回最大 3,000 件)
get_codex_submission_promptAPI ドキュメント付きの Codex 自動投稿プロンプトを生成
get_website_submission_progressサイトのステータス集計と投稿履歴を表示
get_account_backlink_overview全サイトの合計・対応中・完了・失敗の件数を表示

サイトに追加済みのバックリンクは自動でスキップされ、無効な URL は結果に表示されます。

5. 会話の例

https://example.com のサイトを Example という名前で作成して。説明は「AI ライティングツール」。
タグ startup とカテゴリ directory のバックリンクを Example サイトに追加して。
Example の Codex 投稿プロンプトを作って。ディレクトリのみ、最大 20 件。
Example の投稿進捗を確認して、対応が必要な記録を一覧にして。
全サイトのバックリンク投稿状況をまとめて。

注意事項

  1. サイト名、URL、短い説明が未入力のサイトでは Codex 投稿プロンプトを生成できません。先に情報を入力してください。
  2. API キーで接続した場合、生成されるプロンプトにはその API キーが含まれ、そのまま Codex で実行できます。プロンプトは公開しないでください。
  3. サイト数とバックリンクの上限は Web 版と同じく、現在のプランに従います。
  4. Codex の投稿手順は Codex でバックリンクを自動投稿 を参照してください。