Intégration MCP

tokyo.how fournit un serveur MCP (Model Context Protocol) qui permet aux assistants IA comme Claude de rechercher et récupérer directement nos guides sur Tokyo. Au lieu de parcourir le site manuellement, vous pouvez poser des questions à votre assistant IA sur Tokyo et il extraira des informations précises et à jour de notre base de données de guides.

Qu'est-ce que MCP ?

Le Model Context Protocol (MCP) est un standard ouvert développé par Anthropic qui permet aux assistants IA de se connecter à des sources de données et des outils externes. Considérez-le comme un pont entre votre assistant IA et les informations du monde réel.

Avec MCP, votre assistant IA peut aller au-delà de ses données d'entraînement et accéder à des informations structurées en direct depuis des services comme tokyo.how — vous donnant des réponses plus précises et actuelles sur la vie à Tokyo.

Quelles informations pouvez-vous obtenir ?

Via notre serveur MCP, votre assistant IA accède aux outils suivants :

Rechercher des guides

Recherche en texte intégral dans tous les guides tokyo.how. Posez des questions sur n'importe quel sujet — transports, nourriture, logement, santé — et obtenez des résultats classés par pertinence. Prend en charge les requêtes en anglais et en japonais.

Obtenir les détails d'un guide

Récupérer le contenu complet d'un guide spécifique, y compris le texte intégral de l'article, la catégorie et les métadonnées. Votre assistant IA peut lire l'intégralité du guide pour vous fournir des réponses détaillées et précises.

Parcourir les catégories

Lister toutes les catégories de guides disponibles (Transport, Nourriture, Culture, Logement, Finance, Santé, et plus) avec le nombre d'articles, afin d'explorer les sujets couverts.

Lister tous les guides

Parcourir le catalogue complet des guides, filtré optionnellement par langue ou catégorie. Utile pour découvrir des guides dont vous ignoriez l'existence.

Configuration pour Claude Desktop

Suivez ces étapes pour connecter Claude Desktop au serveur MCP de tokyo.how :

Étape 1 : Installer Node.js

Si vous n'avez pas Node.js installé, téléchargez-le depuis nodejs.org. La version LTS est recommandée.

Étape 2 : Ouvrir le fichier de configuration

Ouvrez le fichier de configuration de Claude Desktop :

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

Vous pouvez également y accéder depuis Claude Desktop : cliquez sur le menu Claude → Paramètres → Développeur → Modifier la configuration.

Étape 3 : Ajouter le serveur MCP

Ajoutez l'entrée suivante dans l'objet "mcpServers" de votre fichier de configuration :

{
  "mcpServers": {
    "tokyo.how": {
      "command": "npx",
      "args": [
        "-y",
        "mcp-remote",
        "https://tokyo.how/mcp"
      ]
    }
  }
}

Si vous avez déjà d'autres serveurs MCP configurés, ajoutez simplement l'entrée "tokyo.how" à côté d'eux.

Étape 4 : Redémarrer Claude Desktop

Quittez complètement Claude Desktop et relancez-le. L'indicateur de serveur MCP devrait apparaître dans le coin inférieur droit de la zone de saisie du chat.

Exemples de prompts

Une fois connecté, essayez de demander à Claude :

« Comment utiliser une carte Suica à Tokyo ? »
« Quels sont les meilleurs restaurants de ramen à Tokyo ? »
« Comment ouvrir un compte bancaire au Japon ? »
« Quels guides tokyo.how a-t-il sur les transports ? »
« Montrez-moi toutes les catégories de guides disponibles »

Claude utilisera automatiquement les outils MCP de tokyo.how pour rechercher et récupérer le contenu de guide le plus pertinent pour répondre à votre question.

Dépannage

Si le serveur MCP n'apparaît pas dans Claude Desktop :

Vérifiez que votre syntaxe JSON est correcte (utilisez un validateur JSON si nécessaire)
Assurez-vous que Node.js est installé et que npx est disponible dans votre PATH
Consultez les journaux de Claude Desktop : ~/Library/Logs/Claude/mcp*.log (macOS) ou %APPDATA%\Claude\logs\mcp*.log (Windows)
Essayez de redémarrer Claude Desktop complètement

Pour les autres clients MCP

Le point de terminaison MCP de tokyo.how est disponible à :

https://tokyo.how/mcp

Il utilise le protocole de transport Streamable HTTP et fonctionne en mode sans état. Tout client compatible MCP peut se connecter à ce point de terminaison. Référez-vous à la documentation de votre client pour les instructions de configuration.