Dépannage du New Relic MCP

Le flux OAuth ne démarre pas

• Assurez-vous que votre navigateur peut accéder à localhost.
• Vérifiez les paramètres du pare-feu.
• Vérifiez que vos outils peuvent accéder aux URL OAuth.

La clé API ne fonctionne pas

• Vérifiez le format de la clé (commence par NRAK-).
• Vérifiez les autorisations clés dans New Relic.
• Vérifiez que la clé n'a pas expiré.

Serveur MCP non détecté

• Vérifiez auprès de l’administrateur de votre organisation que MCP est activé dans le gestionnaire de contrôle des fonctionnalités et que les sous-commutateurs requis sont activés.
• Redémarrez complètement l'application.
• Vérifier la validité de la syntaxe JSON.
• Vérifiez les chemins d'accès aux fichiers et les autorisations.

Problèmes de proxy mcp-remote

• Assurez-vous que Node.js est installé.
• Vérifiez votre connexion internet.
• Vérifiez que npx peut accéder au package mcp-remote.

Accès refusé pour les groupes personnalisés

Problème

Vous ne pouvez pas vous connecter ou vous authentifier auprès du serveur New Relic AI MCP et recevez le message d'erreur suivant : Missing required capabilities to access MCP server. Please ensure you have the necessary permissions. Cela se produit généralement si vous êtes membre d'un groupe d'utilisateurs personnalisé sans aucune autorisation au niveau de l'organisation.

Cause

Votre groupe ne dispose pas d'un rôle à l'échelle de l'organisation lui permettant de lire le serveur MCP. L'accès à cette fonctionnalité à l'échelle de l'organisation doit être explicitement accordé à votre groupe via un rôle à portée organisationnelle.

Résolution

L'administrateur de votre organisation qui possède le rôle Authentication Domain Manager doit mettre en œuvre l'une des deux solutions suivantes pour vous accorder l'accès :

1. Attribuez à votre groupe un rôle avec l'autorisation de lire le serveur MCP :

   • L'administrateur doit ajouter l'un des rôles suivants au groupe personnalisé auquel vous appartenez : Organization Read Only, Organization Manager, ou Organization Product admin.
   • L’administrateur peut créer un rôle personnalisé à l’échelle de l’organisation et l’attribuer à un groupe auquel vous appartenez via une autorisation à l’échelle de l’organisation. Ce rôle personnalisé doit inclure l'autorisation de lecture New Relic MCP Server.

2. Vous ajouter à un groupe autorisé :

   • L'administrateur doit vous ajouter à un groupe d'utilisateurs existant qui possède déjà un rôle à l'échelle de l'organisation avec l'autorisation de lire le serveur MCP.

Pour des informations détaillées sur les concepts de gestion des utilisateurs, les rôles et les autorisations d'organisation, reportez-vous à la documentation de gestion des utilisateurs de New Relic. Si votre organisation utilise un système de gestion des identités interdomaines (SCIM) pour la gestion des utilisateurs, ces ajustements de groupe et de rôle doivent être effectués au sein de votre fournisseur d'identité externe (IdP).

Erreur de connexion inattendue dans Claude Code

Problème

Vous recevez une erreur inattendue lors de la connexion au serveur MCP New Relic via Claude Code.

Résolution

Exécutez ce qui suit dans un nouveau terminal, puis reconnectez-vous :

$
claude mcp logout "plugin:nr:nr-mcp-server" 2>&1

Identifiants OAuth obsolètes dans Claude Desktop

Problème

L’erreur de connexion persiste après la déconnexion. Des identifiants OAuth obsolètes mis en cache dans plusieurs espaces de stockage peuvent amener Claude Desktop à réutiliser des identifiants expirés au lieu de s’enregistrer à nouveau.

Résolution

Demandez à Claude de vous aider à localiser et à supprimer les identifiants obsolètes :

Stale OAuth client ID or stale refresh and access tokens for MCP server `newrelic-mcp-server` is making
Claude Desktop's Connect reuses dead credentials instead of re-registering. On macOS, find
every store holding it — the "Claude Code-credentials" keychain item (`.mcpOAuth` keys, watch
for a `plugin:` prefix), `~/Library/Application Support/Claude-3p/config.json`
(`custom3pMcpOAuth."newrelic-mcp-server"`), and every registration across `claude mcp list`,
`~/.claude.json`, and project `.mcp.json` files. Show me which stores match before changing
anything; then clear it (quitting Claude Desktop and backing up config.json first), reconnect,
and confirm a new client ID/new access token is issued.

Messages d’erreur

• Connexion refusée: Vérifiez l'URL et la connectivité réseau de vos outils.
• Authentification requise: Vérifiez que la clé API est toujours active et qu'elle a été saisie correctement ou terminez le flux OAuth.
• Client invalide: problème de configuration OAuth, essayez le proxy mcp-remote.
• Time.UnmarshalJSON: Utiliser mcp-remote comme proxy pour OAuth.

Erreurs FCM

Erreur de clé API

Message d'erreur : Your organization has disabled the API Key sub-toggle under the New Relic MCP Server feature control. Please contact your administrator to enable access.

Cause : le sous-commutateur clé API est désactivé dans le Gestionnaire de contrôle des fonctionnalités.

Résolution :

1. Accédez à Administration sur le portail New Relic.
2. Ouvrez Feature Control et sélectionnez New Relic MCP Server.
3. Sous les sous-commutateurs, activez API Keys.

Erreur de serveur MCP désactivé

Message d'erreur : Your organization has disabled New Relic MCP Server feature control. Please contact your administrator to enable access.

Cause : le commutateur principal de New Relic MCP Server est désactivé dans le gestionnaire de contrôle des fonctionnalités.

Résolution :

1. Accédez à Administration sur le portail New Relic.
2. Ouvrez Feature Control et activez New Relic MCP Server.