PeopleBox ATS — MCP Server

PeopleBox ATS için MCP (Model Context Protocol) server. Claude Desktop veya herhangi bir MCP uyumlu LLM client'ın ATS verilerine erişmesini sağlar.

Kurulum

Gereksinimler

• Node.js v18+
• Git

Adımlar

# 1. Repo'yu klonla
git clone https://github.com/melihguven98/peoplebox-mcp.git

# 2. Bağımlılıkları kur
cd peoplebox-mcp
npm install

# 3. Derle
npm run build

Claude Desktop Yapılandırması

Config dosyasını aç:

• Windows: %APPDATA%\Claude\claude_desktop_config.json
• macOS: ~/Library/Application Support/Claude/claude_desktop_config.json

Aşağıdaki JSON'u yapıştır (args içindeki yolu kendi bilgisayarına göre düzelt):

Windows

{
  "mcpServers": {
    "PeopleBox": {
      "command": "node",
      "args": ["C:\\Users\\KULLANICI\\peoplebox-mcp\\dist\\cli.js"],
      "env": {
        "API_BASE_URL": "https://api.peoplebox.com/api/v1",
        "MCP_API_EMAIL": "recruiter@peoplebox.com",
        "MCP_API_PASSWORD": "sifre123"
      }
    }
  }
}

macOS / Linux

{
  "mcpServers": {
    "PeopleBox": {
      "command": "node",
      "args": ["/Users/KULLANICI/peoplebox-mcp/dist/cli.js"],
      "env": {
        "API_BASE_URL": "https://api.peoplebox.com/api/v1",
        "MCP_API_EMAIL": "recruiter@peoplebox.com",
        "MCP_API_PASSWORD": "sifre123"
      }
    }
  }
}

Önemli: KULLANICI kısmını kendi kullanıcı adınla değiştir.

Claude Desktop'u yeniden başlat. Sol altta MCP tool ikonu görünecek.

Yapılandırma

Çalıştırma Modları

Stdio Modu (Claude Desktop — önerilen)

Claude Desktop bu modu otomatik kullanır. Manuel test için:

API_BASE_URL=https://api.peoplebox.com/api/v1 node dist/cli.js

HTTP Modu (MCP Inspector, Claude Code, vs.)

API_BASE_URL=https://api.peoplebox.com/api/v1 npm start
# → http://localhost:3002/mcp

Mevcut Tool'lar (10 adet)

Aday (Candidate)

Pozisyon (Position)

Pipeline

Mevcut Resource'lar (5 adet)

Test (MCP Inspector)

npx @modelcontextprotocol/inspector

1. Tarayıcıda http://localhost:6274 adresine git
2. Transport type: STDIO
3. Command: node
4. Args: dist/cli.js
5. Environment: API_BASE_URL=https://api.peoplebox.com/api/v1
6. Connect butonuna tıkla

Dosya Yapısı

peoplebox-mcp/
├── package.json
├── tsconfig.json
└── src/
    ├── index.ts              # HTTP server (Express + Streamable HTTP)
    ├── cli.ts                # Stdio CLI (Claude Desktop bu dosyayı çalıştırır)
    ├── config.ts             # Environment değişkenleri
    ├── api-client.ts         # API HTTP client (cookie auth, auto re-login)
    ├── tools/
    │   ├── index.ts          # Tool barrel
    │   ├── candidates.ts     # Aday tool'ları (5 tool)
    │   ├── positions.ts      # Pozisyon tool'ları (3 tool)
    │   └── pipeline.ts       # Pipeline tool'ları (2 tool)
    └── resources/
        ├── index.ts          # Resource barrel
        └── lookups.ts        # Lookup resource'ları (5 resource)

Sorun Giderme