---
title: "Portail des développeurs | stavrospachoundakis.com"
description: "Connectez un agent à stavrospachoundakis.com : un serveur MCP en lecture seule, une API de recherche, llms.txt et llms-full.txt, du Markdown sur demande, les points de terminaison /api/v1 et une fiche d’agent."
canonical: "https://stavrospachoundakis.com/fr/developers"
last-updated: "2026-11-07"
author: "Stavros Pachoundakis"
site: "stavrospachoundakis.com"
language: "fr"
---
# Portail des développeurs | stavrospachoundakis.com
Interfaces lisibles par machine pour ce site (un serveur MCP à /mcp, une API de recherche à /api/v1/search, llms-full.txt, Markdown sur demande et une fiche d’agent), pour les développeurs et pour les agents autonomes. Tout ici est public, en lecture seule, ne demande aucune clé d’API et aucune inscription.
## Ce qu’il y a ici
| Interface | Adresse | Ce qu’elle vous donne |
| --- | --- | --- |
| Serveur MCP | `/mcp` | Recherchez et lisez le site au moyen d’outils (HTTP diffusable, sans état, en lecture seule). |
| API de recherche | `/api/v1/search` | Résultats classés sur les pages, les projets, les rôles et les compétences. |
| Markdown sur demande | n’importe quelle adresse de page | La page en Markdown lorsque vous envoyez `Accept: text/markdown`. |
| llms.txt | `/llms.txt` | Un court profil structuré et des consignes pour les agents. |
| llms-full.txt | `/llms-full.txt` | Tout le site dans un seul fichier. |
| API JSON | `/api/v1/*` | Profil, expérience, projets et compétences en JSON. |
| Fiche d’agent | `/.well-known/agent-card.json` | Fiche d’agent A2A qui décrit le point de terminaison MCP et ses compétences. |
## Se connecter par MCP
Le serveur se trouve à `https://stavrospachoundakis.com/mcp`. Il parle MCP par HTTP diffusable, ne garde aucune session et ne fait que lire. Outils : `search_site`, `get_page`, `get_profile`, `get_experience`, `list_projects`, `get_project`, `get_skills`, `how_to_contact`. Le Markdown de chaque page et llms.txt sont aussi exposés comme ressources.
Ajoutez-le à Claude Code :
```bash
claude mcp add --transport http stavros https://stavrospachoundakis.com/mcp
```
Ajoutez-le à Claude Desktop ou à tout client qui accepte une URL MCP distante :
```json
{
  "mcpServers": {
    "stavros": { "type": "http", "url": "https://stavrospachoundakis.com/mcp" }
  }
}
```
Ou appelez-le à la main. Initialiser :
```bash
curl -X POST https://stavrospachoundakis.com/mcp \
  -H "Content-Type: application/json" \
  -H "Accept: application/json, text/event-stream" \
  -d '{"jsonrpc":"2.0","id":1,"method":"initialize","params":{"protocolVersion":"2025-03-26","capabilities":{},"clientInfo":{"name":"curl","version":"1.0"}}}'
```
Appeler un outil :
```bash
curl -X POST https://stavrospachoundakis.com/mcp \
  -H "Content-Type: application/json" \
  -H "Accept: application/json, text/event-stream" \
  -d '{"jsonrpc":"2.0","id":2,"method":"tools/call","params":{"name":"search_site","arguments":{"query":"Kotlin Multiplatform","limit":5}}}'
```
## API de recherche
```bash
curl "https://stavrospachoundakis.com/api/v1/search?q=kotlin+multiplatform&limit=5&type=project"
```
Paramètres : `q` (obligatoire, jusqu’à 200 caractères), `limit` (1 à 20), `type` (`page`, `project`, `role` ou `skill`). Chaque résultat comporte un titre, une URL, une URL Markdown et un court résumé.
## Markdown sur demande
Envoyez `Accept: text/markdown` à n’importe quelle adresse de page :
```bash
curl -H "Accept: text/markdown" https://stavrospachoundakis.com/fr/about
```
Vous pouvez aussi ajouter `.md` à l’adresse d’une page (`/about.md`, et `/index.md` pour la page d’accueil).
## llms.txt et llms-full.txt
```bash
curl https://stavrospachoundakis.com/fr/llms.txt
curl https://stavrospachoundakis.com/fr/llms-full.txt
```
`/llms.txt` est la version courte. `/llms-full.txt` contient dans un seul fichier chaque page, chaque projet, chaque rôle et chaque groupe de compétences.
## Fiche d’agent
`https://stavrospachoundakis.com/.well-known/agent-card.json` est une fiche d’agent A2A. Elle décrit un agent d’information en lecture seule sur Stavros, accessible par le point de terminaison MCP ci-dessus. Ses compétences reflètent les outils MCP.
## API REST : /api/v1
URL de base : `https://stavrospachoundakis.com/api/v1`. Description complète lisible par machine : [openapi.json](https://stavrospachoundakis.com/openapi.json) (OpenAPI 3.1).
| Point de terminaison | Méthode | Description |
| --- | --- | --- |
| `/profile` | GET | Profil structuré complet : biographie, lieu, parcours professionnel, compétences, faits saillants, disponibilité, liens. |
| `/experience` | GET | Parcours professionnel. |
| `/skills` | GET | Compétences regroupées par discipline. |
| `/projects` | GET | Projets. |
| `/search` | GET | Recherchez dans les pages, les projets, les rôles et les compétences (`q`, `limit`, `type`). |
| `/posts` | GET | Renvoie une liste vide. Ce site n’a aucun article. |
Les réponses réussies ont la forme `{ "apiVersion": "v1", "data": ..., "meta": ... }`.
### Authentification
Aucune. Il n’y a ni clé d’API, ni flux OAuth, ni inscription. Voir [auth.md](https://stavrospachoundakis.com/fr/auth.md) pour le portrait complet.
### Versionnage et dépréciation
L’API est versionnée dans le chemin de l’URL. Les changements incompatibles sont publiés sous un nouveau segment (`/api/v2`) et la version précédente continue de fonctionner. Les changements additifs (nouveaux champs, nouveaux paramètres facultatifs, nouveaux points de terminaison) sont faits sur place, de sorte que **les clients doivent ignorer les champs inconnus**. Une version dont le retrait est prévu est annoncée sur cette page et dans la description OpenAPI, au moins **180 jours** avant qu’elle cesse de répondre.
### Erreurs
Les points de terminaison du profil, de l’expérience, des compétences et des projets sont du JSON statique en lecture seule. Un chemin qui n’existe pas renvoie un simple HTTP `404`, et toute méthode autre que GET renvoie `405`.
## Fichiers lisibles par machine
| Chemin | Type de contenu | Description |
| --- | --- | --- |
| `/llms.txt` | `text/plain` | Profil structuré complet, rôles, compétences et conseils sur les mandats les mieux adaptés. Le site entier dans un seul fichier se trouve à /llms-full.txt. |
| `/llms-full.txt` | `text/plain` | Tout le site dans un seul fichier. |
| `/openapi.json` | `application/openapi+json` | Description OpenAPI 3.1 de l’API ci-dessus. |
| `/auth.md` | `text/markdown` | Comment fonctionne l’authentification (elle n’existe pas : tout est public). |
| `/.well-known/ai-catalog.json` | `application/json` | Catalogue Agentic Resource Discovery. |
| `/.well-known/agent-card.json` | `application/json` | Fiche d’agent A2A pour le point de terminaison MCP. |
| `/sitemap.xml` | `application/xml` | Chaque URL canonique. |
| `/robots.txt` | `text/plain` | Politique d’exploration. Les robots d’indexation et les agents d’IA sont les bienvenus. |
## Notes sur les limites de débit et la confidentialité
Chaque interface est en lecture seule et sans effet de bord, donc il est sûr d’appeler la production directement. Veuillez garder un volume de test raisonnable. Aucune clé n’est nécessaire et aucune n’est conservée. Les coordonnées ne sont jamais exposées aux agents : l’outil `how_to_contact` et la page de contact renvoient vers le formulaire de contact, qui comporte une vérification humaine.
## Erreurs et 404
Les chemins inconnus renvoient un simple HTTP `404`, jamais un 200 avec la coquille de l’application, de sorte que vous pouvez vous fier aux codes d’état lorsque vous sondez.
## Code source
Les dépôts derrière ce site sont privés. Profil public : [github.com/stavroschios](https://github.com/stavroschios).
## Contact
Bogues, questions ou aide à l’intégration : utilisez la page de contact (vérification humaine requise).