MCP 経由で Avito を Cursor に接続する方法

💡 インストール不要? cloud.anythingmcp.com を直接利用してください。 サインインし、Connectors → Avito をクリック、認証情報を貼り付け、MCP API キーを発行すれば完了です。Docker も git clone もローカルサーバーも不要。

Avito + Cursor

AI を Avito のビジネスアカウントで働かせます。広告の一覧表示と価格変更、閲覧数・問い合わせ・通話の統計の読み取り、オートロードのアップロードとそのエラー、フィード形式、ウォレットの確認、Avito Messenger のチャットの読み取りができます。メッセージ送信とオートロード設定の変更はオプションで、初期状態ではオフです。

前提条件

完全なセットアップ手順はコネクタ自体に組み込まれています (ストアでコネクタを選択すると表示)。必要な環境変数:

AVITO_CLIENT_ID, AVITO_CLIENT_SECRET

ステップ 1 — 認証情報を取得

セットアップは約 5 分で、Avito のビジネスアカウントとその API 認証情報が必要です。ブラウザーでのサインインはありません。

1. AI に使わせたいビジネスアカウントで Avito にサインインします。従業員のアカウントではなく、会社のメインアカウントを使ってください。
2. Для профессионалов から API интеграции（avito.ru/professionals/api）を開き、Client ID と Client secret をコピーします。Avito が発行するのは 1 アカウントにつき 1 組だけで、新しい secret を生成すると古いものは使えなくなります。
3. それぞれを AVITO_CLIENT_ID と AVITO_CLIENT_SECRET に貼り付けてインストールします。AnythingMCP が Avito からアクセストークンを自動で取得し、24 時間ごとに更新します。
4. avito_get_self を実行します。アカウントの名前、メールアドレス、ユーザー ID が表示されます。この ID が他のツールで必要な user_id で、AI は会話の間ずっとこれを使い回します。

使える機能は Avito の料金プランで決まります: API でできるのは、そのアカウント自体に許可されていることだけです。Messenger API は、商品と求人では Максимальный（最上位）プラン、サービスでは Расширенный（拡張）または Максимальный プランでのみ使えます。それ以外ではチャット系ツールが 403 を返します。オートロード系ツールには、アカウントでオートロードが設定されている必要があります。

読み取れるデータ: アカウントとウォレット（ルーブル建ての実残高とボーナス）、掲載料やプロモーションの請求履歴。タイトル、価格、ステータス、カテゴリー、住所、適用中の有料サービス（vip、highlight、pushup、premium、xl）と終了日を含む広告。最大 200 件の広告をまとめて、最大 270 日前までさかのぼったユニーク閲覧数、問い合わせ数、お気に入り数。広告別・日別の通話数。オートロードの設定、各アップロードとその中の広告ごとのエラーと警告。カテゴリーごとのフィード項目。そして Avito Messenger のチャットとメッセージです。従業員サブアカウントの広告は一覧に出ず、チャットを読んでも既読にはなりません。

広告ごとに 2 つの ID: Avito ID は広告 URL に含まれる番号です。オートロードのフィードから来た広告には、フィード独自の Id もあります。AI が両者を変換するので、どちらの ID で尋ねても構いません。

変更の前に必ず確認: avito_update_item_price は 1 件の広告の価格を、ルーブルの整数で変更します（商品、部品、自動車、不動産が対象で、短期賃貸は対象外です）。新しい価格はすぐに公開されるため、AI は先に対象の広告、現在の価格、新しい価格を示し、あなたの承認を待ちます。広告がオートロードのフィードから来ている場合、次のアップロードでフィードの価格に戻ることがあるので、フィード側も変更してください。

インストール時はオフ: avito_send_message（アカウントの名前で購入者にメッセージを送ります。最大 1,000 文字で、ここからは取り消せません）、avito_mark_chat_read（未読マークが消えるため、同僚がメッセージを見落とすおそれがあります）、avito_update_autoload_profile（オートロードのプロフィール全体を置き換えます）、avito_start_autoload_upload（スケジュールの上限を無視してフィードの全広告を一度に公開するため掲載料がかかることがあり、実行は 1 時間に 1 回までです）。管理者が意図して有効にでき、その場合でも AI は送る文面や変更内容を正確に示し、あなたの確認を待ちます。

購入者のデータ: チャットには購入者の名前とメッセージが含まれます。AI はそれをその購入者への対応にだけ使い、先に連絡してきていない人にメッセージを送ることはありません。

時刻と言語: Avito はモスクワ時間（UTC+3）で動いており、AI は時刻を変換してから伝えます。Avito からのメッセージはロシア語なので、AI が翻訳します。

制限: 広告の一覧は 1 分あたり最大 25 リクエスト、価格変更は 1 分あたり 150、広告 1 件の読み取りは 1 分あたり 500 です。ウォレットの履歴は 1 回の取得で最大 1 週間分、1 年前までです。429 が返ったら AI は 1 分待ってから再試行します。

よくあるエラー: 401 Bad bearer token または 403 invalid access token は、Client ID か secret が間違っているか、新しく生成した secret に置き換わったことを示します。それ以外の 403 は、料金プランにその API（特に Messenger）が含まれていないことを示します。404 は広告、チャット、アップロードが存在しないか別のアカウントのものであることを示し、オートロードのレポートはアップロードがまだない間も 404 を返します。400 はパラメーターの誤りで、たとえばここでは価格を変更できないカテゴリーの価格や、1 週間を超えるウォレットの期間指定です。

このコネクターは、プロモーションサービスとその料金、広告キャンペーン、CPA とコールトラッキング、配送と注文、評価とレビュー、Avito Jobs、短期賃貸、従業員アカウント、Webhook、画像や音声メッセージの送信には対応していません。広告の内容の作成や編集も行いません。それはオートロードのフィードで行います。

ステップ 2 — アダプターをインストール

curl -fsSL https://raw.githubusercontent.com/HelpCode-ai/anythingmcp/main/docker-compose.quickstart.yml -o docker-compose.yml
printf 'JWT_SECRET=%s\nENCRYPTION_KEY=%s\n' "$(openssl rand -hex 32)" "$(openssl rand -hex 32)" > .env
docker compose up -d

ステップ 3 — Cursor にコネクタを追加

サーバーURL: AnythingMCP で MCP Servers を開き、このコネクタがあるサーバーを選んで URL（https://cloud.anythingmcp.com/mcp/…）をコピーします。このガイドで YOUR_SERVER_ID と表示されている箇所に使ってください。

Cursor は ~/.cursor/mcp.json から MCP サーバーを読み込みます。次のエントリを追加してください:

{
  "mcpServers": {
    "anythingmcp": {
      "url": "https://cloud.anythingmcp.com/mcp/YOUR_SERVER_ID",
      "headers": { "X-API-Key": "YOUR_MCP_API_KEY" }
    }
  }
}

1. AnythingMCP の MCP Servers → 対象のサーバー → API keys で MCP API キーを作成し、YOUR_MCP_API_KEY と置き換えます。
2. ファイルを保存し、Cursor を再起動します。
3. Cursor → Settings → MCP を開き、anythingmcp が一覧にあり接続済みであることを確認します。
4. チャットを始めましょう。エージェントが Avito のツールを呼び出せるようになりました。

利用可能なツール

プロンプトの例

• 「公開中の広告のうち、過去 30 日間で閲覧数と問い合わせが最も多かったのはどれですか。まったく反応がなかった広告も教えてください。」
• 「『iPhone 13 128 GB』の広告の価格を 42,000 ルーブルに下げてください。先に現在の価格と新しい価格を見せてください。」
• 「前回のオートロードのアップロードでエラーはありましたか。エラーのある広告と、フィードで直すべき点を教えてください。」
• 「Avito Messenger で未読のチャットはどれですか。購入者が何を尋ねているかまとめてください。」
• 「先週 Avito のウォレットから何にいくら引き落とされましたか。現在の残高も教えてください。」

FAQ

Cursor の無料プランでカスタム MCP サーバーは使えますか? はい。MCP は Hobby、Pro、Business の各プランで利用できます。

次のステップ

• コネクタのランディング
• Claude に接続
• ChatGPT に接続