Loxo MCP Server

🚀 Loxo MCP サーバ

このサーバは、モデルコンテキストプロトコル（MCP）サーバであり、Loxo 採用プラットフォーム API とのやり取りを可能にするツールを提供します。このサーバを使用すると、AI アシスタントが候補者管理、求人管理、活動管理、電話キュー管理など、さまざまな採用関連のタスクを実行できます。

🚀 クイックスタート

このセクションでは、Loxo MCP サーバのセットアップと使用方法を説明します。

📦 インストール

以下の手順に従って、サーバをインストールします。

# リポジトリをクローンする
git clone [repository-url]
cd loxo-mcp-server

# 依存関係をインストールする
npm install

# プロジェクトをビルドする
npm run build

📚 ドキュメント

設定

提供されている .env.example ファイルをコピーして .env という名前に変更し、必要な値を入力します。

cp .env.example .env

次に、.env ファイル内の設定を更新します。

LOXO_API_KEY=your_api_key
LOXO_AGENCY_SLUG=your_agency_slug
LOXO_DOMAIN=app.loxo.co

必要な環境変数は以下の通りです。

• LOXO_API_KEY：あなたの Loxo API キー
• LOXO_AGENCY_SLUG：Loxo 内のあなたの代理店識別子
• LOXO_DOMAIN：（オプション）デフォルトは 'app.loxo.co'

利用可能なツール

活動管理

• get-activity-types：利用可能なすべての活動タイプを取得します。
• spark-search-activity-types：Spark Search から活動タイプを取得します。
• get-todays-tasks：今日のすべてのタスクと予定された活動を取得します。
• schedule-activity：将来の活動（電話、会議など）を予定します。
• log-activity：候補者または求人の活動を記録します。

電話キュー管理

• get-call-queue：現在の電話キューを表示します。
• add-to-call-queue：候補者または連絡先を電話キューに追加します。

候補者管理

• search-candidates：Loxo 内で候補者を検索します。
• get-candidate：特定の候補者の詳細情報を取得します。
• add-note：候補者にメモを追加します。

求人管理

• search-jobs：Loxo 内で求人を検索します。
• get-job：特定の求人情報を取得します。
• add-note：求人にメモを追加します。

開発

# 監視機能付きで開発モードで実行する
npm run dev

# プロジェクトをビルドする
npm run build

# サーバを起動する
npm start

型安全

このサーバは、Zod を使用して実行時の型検証を行います。

• 環境変数
• ツールの入力パラメータ
• API レスポンス

エラー処理

サーバには包括的なエラー処理機能が備わっています。

• 環境変数の検証
• API リクエストの失敗
• 無効なツールパラメータ
• 未知のツールリクエスト

アーキテクチャ

• Model Context Protocol SDK を使用して構築されています。
• stdio を介した通信を行い、AI アシスタントとのシームレスな統合を実現します。
• TypeScript を使用して型安全と良好な開発体験を実現します。
• Loxo プラットフォームの RESTful API 呼び出しを実装しています。