概要
Pinpoint 採用管理(ATS):求人、求人掲載、採用ワークフローとステージ、応募、候補者、面接、コメント、スコアカード、採用申請、ユーザー、組織構造。自社の pinpointhq.com サブドメイン上の JSON:API v1、X-API-KEY ヘッダー。
ガイド付きセットアップ
Pinpoint を Microsoft Copilot に 2 分で接続
AnythingMCP Cloud の無料トライアルを始め、ガイド付きセットアップで Pinpoint を接続して、MCP URL を Microsoft Copilot に追加します。コードもサーバーの運用も不要です。
クレジットカード不要 · 7日間の試用 · セルフホストの選択肢あり
こう聞いてみよう
Pinpoint のサンプルプロンプト
プロンプトをクリックでコピー。Claude / ChatGPT / Cursor / Gemini / Copilot / OpenClaw に貼り付けて、このコネクターで実行できます。
Claude は AI のため誤ることがあります。回答をご確認ください。
💡 インストール不要? cloud.anythingmcp.com を直接利用してください。 サインインし、Connectors → Pinpoint をクリック、認証情報を貼り付け、MCP API キーを発行 — 完了です。Docker も
git cloneもローカルサーバーも不要。
Pinpoint + Microsoft Copilot
Pinpoint 採用管理(ATS):求人、求人掲載、採用ワークフローとステージ、応募、候補者、面接、コメント、スコアカード、採用申請、ユーザー、組織構造。自社の pinpointhq.com サブドメイン上の JSON:API v1、X-API-KEY ヘッダー。
前提条件
完全なセットアップ手順はコネクタ自体に組み込まれています (ストアでコネクタを選択すると表示)。必要な環境変数:
PINPOINT_SUBDOMAIN, PINPOINT_API_KEY
ステップ 1 — 認証情報を取得
このコネクタは、自社専用サブドメイン上の Pinpoint JSON:API v1 を API キーで読み取ります。書き込みツールは 2 つで、社内コメントの追加と応募のステージ移動ができます。
PINPOINT_SUBDOMAINには、ログインするアドレスの.pinpointhq.comより前の部分を入れます。acme.pinpointhq.comならacmeです。- Pinpoint の管理者が Settings > API & Webhooks を開き、Pinpoint API のトグルをオンにします。オフのままではキーを作成できず、呼び出しは 403 を返します。
- API Keys タブでキーを作成し、
PINPOINT_API_KEYに貼り付けます。Pinpoint は AI ツール用に読み取り専用の別キーを推奨しています。pinpoint_add_commentとpinpoint_move_application_stageには書き込み権限のあるキーが必要です。 - まず
pinpoint_list_jobs(ステータスopen)、次にjob_idを指定してpinpoint_list_applications、詳細はinclude=candidate,stageを付けたpinpoint_get_applicationで取得します。
注意点:
- 応答は JSON:API 形式です。レコードは
data[]、includeで要求した関連レコードはincluded[]に入ります。ID は文字列です。 pageは 1 から、page_sizeの既定値は 100(最大 1000)です。機密求人はvisibilityにconfidentialを指定しない限りpinpoint_list_jobsに表示されません。- 上限は IP あたり 1 分 120 リクエスト、8 分 240 リクエストです。超えると Pinpoint は
Retry-After付きの 429 を返します。個別取得を繰り返すより、include付きで絞り込んだ一覧呼び出し 1 回のほうが適しています。 - 応募を移動すると、移動先ステージに設定された自動メールが送信されることがあります。コメントは採用チームに表示され、候補者には表示されません。
ステップ 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 — Microsoft Copilot にコネクタを追加
サーバーURL: AnythingMCP で MCP Servers を開き、このコネクタがあるサーバーを選んで URL(
https://cloud.anythingmcp.com/mcp/…)をコピーします。このガイドでYOUR_SERVER_IDと表示されている箇所に使ってください。
Microsoft Copilot は、Copilot Studio で作成したエージェントを通じて MCP サーバーを使います。AnythingMCP をツールとしてエージェントに追加し、そのエージェントを Microsoft 365 Copilot と Teams に公開します。Copilot Studio は Microsoft のクラウドから Streamable HTTP で接続し、AnythingMCP はこれに対応しています。
- Copilot Studio でエージェントを開き(または新規作成し)、Tools で Add a tool → New tool → Model Context Protocol を選びます。
- Server name(例:
AnythingMCP)、コネクタでできることを説明する Server description、Server URLhttps://cloud.anythingmcp.com/mcp/YOUR_SERVER_IDを入力します。Copilot Studio はこの説明をもとに、いつサーバーを呼び出すかを判断します。 - 認証で API key を選び、Type を Header、ヘッダー名を
X-API-Keyにして Create を選びます。 - Add tool で Create a new connection を選び、AnythingMCP の MCP API キー(MCP Servers → 対象のサーバー → API keys)を貼り付けて Add to agent を選びます。
- エージェントの Test ウィンドウで試します。
Pinpointのツールが必要になる依頼をしてみましょう。 - Publish を選び、Channels → Microsoft 365 and Microsoft Teams で Make agent available in Microsoft Copilot を選択したまま Add channel を選びます。See agent in Teams で自分用にインストールされます。Microsoft 365 Copilot では @ を入力してエージェントを選びます。
ユーザーごとにサインインさせたい場合は、API キーの代わりに OAuth 2.0 → Dynamic discovery を選びます。各ユーザーは、エージェントが初めて呼び出すときに AnythingMCP にサインインします。
セルフホストの場合は、https://cloud.anythingmcp.com の代わりにインスタンスの公開 HTTPS アドレスを使ってください。Copilot Studio は Microsoft のクラウドから接続するため、localhost は使えません。
利用可能なツール
| Tool | What it does |
|---|---|
pinpoint_list_jobs | List jobs (vacancies) with title, status, visibility, employment type, workplace type and dates |
pinpoint_get_job | Return one job by id with its attributes; use include to embed the hiring stages, job postings, questions, managers, department and location |
pinpoint_list_applications | List applications (a candidate applying to a job) with stage, status dates, source and contact details |
pinpoint_get_application | Return one application by id; include=stage,candidate,job,answers,offers,comments embeds the current stage, the candidate, the job… |
pinpoint_list_candidates | List candidates (people, across all their applications) with name, e-mail, phone and timestamps |
pinpoint_get_candidate | Return one candidate by id with contact details; include=applications lists every application of this person |
pinpoint_list_comments | List comments (internal notes) with text, author and date |
pinpoint_list_interviews | List scheduled interviews with start and end time, attendance (attended, no_show) and the stage |
pinpoint_get_interview | Return one interview by id with its times, attendance and, with include, the stage, the interview parts and the application interviewed |
pinpoint_list_hiring_workflows | List hiring workflows (the stage pipelines jobs use). include defaults to stages, so each workflow comes with its ordered stages and their… |
pinpoint_list_job_postings | List job postings (the adverts of a job on the careers site and job boards) with title, status, employment and workplace type |
pinpoint_list_departments | List the company's departments with id and name |
pinpoint_list_divisions | List the company's divisions with id and name, the level above departments in Pinpoint's company structure |
pinpoint_list_locations | List the company's locations with id, name and address |
pinpoint_list_users | List Pinpoint users (recruiters, hiring managers, interviewers) with name, e-mail and role |
pinpoint_list_scorecards | List the interview scorecard templates with their sections and the stages they apply to (use include) |
pinpoint_list_requisitions | List job requisitions (approved requests to hire) with identifier, status and dates |
pinpoint_add_comment | Add an internal comment (note) to an application, a candidate or a job seeker |
pinpoint_move_application_stage | Move an application to another stage of its hiring workflow, e.g. from review to interview |
FAQ
どの Copilot が対象ですか? 職場で使う Microsoft 365 Copilot で、Copilot Studio のエージェントを通じて利用します。個人アカウント向けの Microsoft Copilot アプリでは、独自の MCP サーバーを追加できません。
何が必要ですか? エージェントを作成するために、Copilot Studio を利用できる職場アカウント(ライセンスまたは試用版)が必要です。Microsoft 365 Copilot や Teams でエージェントを使う人には、エージェントへのアクセス権が必要です。共有するか、管理者に組織向けに公開してもらってください。組織が Power Platform コネクタにデータ ポリシーを適用している場合は、MCP サーバーにも適用されます。
エージェントがツールを呼び出しません。 ヘッダー名が正確に X-API-Key であること、キーが URL と同じ MCP サーバーのものであることを確認し、Server description を具体的に書いてください。Copilot Studio はこの説明をもとにサーバーを呼び出すかどうかを判断します。変更のたびにエージェントを再公開し、開いているチャットでは "start over" と入力すると新しいバージョンになります。
次のステップ
このガイドは役に立ちましたか?