Skill pour Claude Code (au lieu d'un serveur MCP)

Important — clarification 2026-05-16 : Rankion n'opère aucun serveur MCP. Les versions précédentes de ce wiki annonçaient un endpoint MCP prévu sous /mcp — ce plan est abandonné. À la place, nous fournissons un Skill (un seul fichier Markdown pour Claude Code), notre API REST avec plus de 130 endpoints, et une spec OpenAPI pour tous les autres agents.

Ce que vous obtenez à la place

1. Skill pour Claude Code — un fichier Markdown sous https://rankion.ai/claude-skill que Claude Code lit directement. Pas de paquet npm, pas de serveur MCP, pas d'infrastructure additionnelle.
2. API REST — plus de 130 endpoints sous https://rankion.ai/api/v1/..., documentés dans la référence API. Auth via tokens Sanctum.
3. Spec OpenAPI — lisible par machine sous https://rankion.ai/api/openapi.json. Utilisez-la pour générer automatiquement des clients typés pour n'importe quel framework d'agent (n8n, Zapier, connecteur ChatGPT, outils custom).

Un seul token Sanctum fonctionne pour les trois voies.

Setup pour Claude Code en 2 minutes

# 1. Créer le répertoire du skill
mkdir -p ~/.claude/skills/rankion-api

# 2. Télécharger le Markdown du skill
curl -o ~/.claude/skills/rankion-api/SKILL.md https://rankion.ai/claude-skill

# 3. Définir votre token Sanctum (copié depuis Paramètres → API)
export RANKION_API_TOKEN="rk_live_..."

# 4. Lancer Claude Code — le skill est immédiatement disponible
claude "Recherche des mots-clés pour 'AI Content Marketing' et rédige un article"

Créez le token dans l'UI sous Paramètres → API.

Pour les autres agents (connecteur ChatGPT, Cursor, n8n, Zapier, custom)

Tous les agents non-Claude appellent l'API REST directement. Exemple :

curl -X POST https://rankion.ai/api/v1/generate/article \
  -H "Authorization: Bearer $RANKION_API_TOKEN" \
  -H "Content-Type: application/json" \
  -d '{"project_id": 1, "keyword": "AI Content Marketing", "article_type": "blog-post"}'

Pour les frameworks qui comprennent OpenAPI : chargez https://rankion.ai/api/openapi.json et générez automatiquement des clients typés.

Si votre agent exige absolument MCP

Au 2026-05-16, nous n'avons pas rencontré un tel cas. Les clients MCP actuels (Claude Desktop, Cursor, Windsurf) peuvent dans presque toutes les configurations appeler les APIs REST directement — ou, dans le cas de Claude Code, charger un skill. Si votre cas concret nécessite strictement un serveur MCP, écrivez à info@provimedia.de — nous évaluons au cas par cas ; aucun engagement de roadmap.

Bonnes pratiques

• Ne commit jamais le token Sanctum. Gardez-le en .env ou injectez via un gestionnaire de secrets.
• Un token, une équipe. Les tokens Sanctum sont scopés par équipe — ils ne voient que l'équipe propriétaire.
• Respectez les rate limits. Le Skill et la doc OpenAPI listent les rate limits par endpoint (typiquement 60/min).
• Pollez correctement les endpoints async. Les opérations longues (génération d'article 30-90 s, audits) renvoient HTTP 202 avec un job ID — pollez le endpoint GET de statut jusqu'à status: "completed".

Articles wiki liés

• Index API REST
• Authentification via tokens Sanctum
• Master Agent / Agentic Chat — raisonnement multi-étapes via POST /v1/agentic/chat