MCP-iQuesta

iQuesta MCP Server

iQuesta.com 向けのModel Context Protocol コネクターです。フランスでのインターンシップおよび就業研修先を検索するプラットフォームです。

MCP 対応の AI エージェント（Claude、ChatGPT、Gemini など）なら、会話中に求人情報を直接検索できます。

エンドポイント

https://mcp.iquesta.com/api/mcp

プロトコル：MCP 2024-11-05 · トランスポート：Streamable HTTP · スタック：Laravel 10 / PHP 8.1

利用可能なツール

ツール	説明
search_jobs	キーワード（タイトル）、求人広告の説明、地域、分野、専攻、契約タイプで求人情報を検索します
get_job	ID を指定して求人情報の詳細をすべて取得します
list_filters	フィルターに指定できる値（地域、分野、専攻、契約タイプ）を一覧表示します

注：ツール get_similar_jobs は一時的に無効になっています。対応する API エンドポイントが iQuesta 側にまだ存在しないためです。開発が完了したら再び有効になります。

search_jobs のパラメーター

パラメーター	型	説明
term	string	求人広告のタイトルから検索するキーワード
description	string	求人広告の全文（業務内容、必要なスキルなど）から検索するキーワード
disciplines	integer	分野 ID。list_filters(filter='disciplines') で取得します。例：3 = "商業／流通／販売"
matieres	integer[]	専攻 ID の一覧（disciplines より細かい分類）。list_filters(filter='matieres') で取得します。例：27 = "情報技術 - 開発"
regions	integer	フランスの地域 ID。list_filters(filter='regions') で取得します
contracts	string	契約タイプの ID：1（インターンシップ）、2（就業研修）、-4（雇用）、-5（学生アルバイト）
begin	integer	希望する開始月（1-12）
duration	integer	業務の最長期間（月単位）
limit	integer	最大結果数（デフォルト：10、推奨される上限：20）

term、description、matieres、disciplines、regions のいずれかのパラメーターが必須です。

disciplines（60 種類）と matieres（68 種類）について：各専攻は分野に属します。ほとんどは一対一で対応し、一部の分野（化学、不動産）のみ細分化されています。まず disciplines を使用し、より細かく絞り込む場合は matieres を使用してください。

使用例

初期化

curl -X POST https://mcp.iquesta.com/api/mcp \
  -H "Content-Type: application/json" \
  -d '{"jsonrpc":"2.0","id":1,"method":"initialize","params":{}}'

ツール一覧

curl -X POST https://mcp.iquesta.com/api/mcp \
  -H "Content-Type: application/json" \
  -d '{"jsonrpc":"2.0","id":2,"method":"tools/list","params":{}}'

タイトルと地域で求人情報を検索

curl -X POST https://mcp.iquesta.com/api/mcp \
  -H "Content-Type: application/json" \
  -d '{
    "jsonrpc": "2.0",
    "id": 3,
    "method": "tools/call",
    "params": {
      "name": "search_jobs",
      "arguments": {
        "term": "développeur",
        "regions": 10,
        "contracts": "1"
      }
    }
  }'

専攻と説明で検索

curl -X POST https://mcp.iquesta.com/api/mcp \
  -H "Content-Type: application/json" \
  -d '{
    "jsonrpc": "2.0",
    "id": 5,
    "method": "tools/call",
    "params": {
      "name": "search_jobs",
      "arguments": {
        "description": "Python",
        "matieres": [27]
      }
    }
  }'

利用可能なフィルターを一覧表示

curl -X POST https://mcp.iquesta.com/api/mcp \
  -H "Content-Type: application/json" \
  -d '{
    "jsonrpc": "2.0",
    "id": 4,
    "method": "tools/call",
    "params": { "name": "list_filters", "arguments": { "filter": "all" } }
  }'

クライアント側の設定

Claude.ai / Claude Desktop

コネクターの設定に追加します：

{
  "mcpServers": {
    "iquesta": {
      "url": "https://mcp.iquesta.com/api/mcp"
    }
  }
}

iQuesta について

iQuesta.com は、学生および若手の卒業生を対象に、フランスのインターンシップや就業研修先の求人情報を数千件掲載しています。

ライセンス

MIT