WhyEva MCP Server

Aperçu #

Le serveur MCP WhyEva implémente le Model Context Protocol via Streamable HTTP. Il expose des outils pour les agents IA afin de lire et écrire des données dans votre compte WhyEva — sans écrire de code d'intégration.

Le serveur utilise le transport JSON-RPC 2.0 via un seul endpoint POST /mcp. L'authentification s'effectue via un token JWT Bearer standard.

Endpoint #

Toutes les requêtes MCP sont envoyées à un seul endpoint :

Le serveur prend en charge uniquement la méthode POST. GET et DELETE retournent 405 Method Not Allowed.

Authentification #

Le point de terminaison MCP nécessite un token JWT Bearer valide. Obtenez-en un via l'API WhyEva et transmettez-le avec chaque requête.

POST https://my.whyeva.fr/api/account/login
Content-Type: application/json

{
  "email": "user@example.com",
  "password": "your-password"
}

Authorization: Bearer <your-access-token>

Connexion rapide #

Ajoutez le serveur MCP WhyEva à votre client IA en collant la configuration ci-dessous. Remplacez par le token Bearer obtenu ci-dessus.

{
  "mcpServers": {
    "whyeva": {
      "url": "https://my.whyeva.fr/mcp",
      "headers": {
        "Authorization": "Bearer <YOUR_TOKEN>"
      }
    }
  }
}

{
  "mcpServers": {
    "whyeva": {
      "type": "http",
      "url": "https://my.whyeva.fr/mcp",
      "headers": {
        "Authorization": "Bearer <YOUR_TOKEN>"
      }
    }
  }
}

{
  "servers": {
    "whyeva": {
      "type": "http",
      "url": "https://my.whyeva.fr/mcp",
      "headers": {
        "Authorization": "Bearer ${input:whyevaToken}"
      }
    }
  },
  "inputs": [
    {
      "id": "whyevaToken",
      "type": "promptString",
      "description": "WhyEva JWT Bearer Token",
      "password": true
    }
  ]
}

{
  "mcpServers": {
    "whyeva": {
      "serverUrl": "https://my.whyeva.fr/mcp",
      "headers": {
        "Authorization": "Bearer <YOUR_TOKEN>"
      }
    }
  }
}

curl -X POST https://my.whyeva.fr/mcp \
  -H "Content-Type: application/json" \
  -H "Authorization: Bearer <YOUR_TOKEN>" \
  -d '{
    "jsonrpc": "2.0",
    "id": 1,
    "method": "initialize",
    "params": {
      "protocolVersion": "2024-11-05",
      "capabilities": {},
      "clientInfo": { "name": "my-agent", "version": "1.0" }
    }
  }'

Outils #

Le serveur expose 29 outils en trois catégories. Appelez tools/list pour récupérer la liste complète avec les définitions JSON Schema.

Offres d'emploi  16 tools

Questions  6 tools

Candidats  7 tools

Méthodes JSON-RPC #

Le serveur implémente le transport MCP Streamable HTTP en utilisant JSON-RPC 2.0.

initialize

Effectue le handshake MCP et retourne les capacités du serveur.

{
  "jsonrpc": "2.0",
  "id": 1,
  "method": "initialize",
  "params": {
    "protocolVersion": "2024-11-05",
    "capabilities": {},
    "clientInfo": { "name": "my-agent", "version": "1.0" }
  }
}

{
  "jsonrpc": "2.0",
  "id": 1,
  "result": {
    "protocolVersion": "2024-11-05",
    "capabilities": { "tools": { "listChanged": false } },
    "serverInfo": { "name": "WhyEva-MCP", "version": "1.0.0" }
  }
}

tools/list

Retourne tous les outils disponibles avec leurs définitions JSON Schema.

{ "jsonrpc": "2.0", "id": 2, "method": "tools/list" }

tools/call

Invoque un outil spécifique par nom, en passant des arguments sous forme d'objet JSON.

{
  "jsonrpc": "2.0",
  "id": 3,
  "method": "tools/call",
  "params": {
    "name": "getVacancy",
    "arguments": {
      "vacancyId": "3fa85f64-5717-4562-b3fc-2c963f66afa6"
    }
  }
}

notifications/initialized

Envoyé par le client après un initialize réussi. Le serveur retourne 200 OK sans corps.

Codes d'erreur #