Authentification MCP

Le serveur MCP d'Almirant requiert une clé API valide pour toutes les opérations. L'authentification s'effectue au moyen de l'en-tête Authorization avec un jeton Bearer.

Obtenir une clé API

1. Dans Almirant, accédez à Settings depuis le menu latéral
2. Accédez à la section API Keys
3. Cliquez sur Créer une clé API
4. Donnez-lui un nom descriptif (par exemple, "Claude Code - Mon projet")
5. Copiez la clé API générée

Conservez votre clé API

La clé API n'est affichée qu'une seule fois lors de sa création. Copiez-la et conservez-la dans un endroit sûr. Si vous la perdez, vous devrez en générer une nouvelle.

Pour plus de détails sur la gestion des clés API, consultez la documentation des clés API dans la section des fonctionnalités.

URL du serveur MCP

https://api.almirant.ai/mcp

Pour le développement local :

http://localhost:3001/mcp

En-tête d'authentification

Toutes les requêtes doivent inclure l'en-tête :

Authorization: Bearer <tu-api-key>

Configuration dans Claude Code

Créez ou modifiez le fichier .mcp.json à la racine de votre projet :

{
  "mcpServers": {
    "almirant": {
      "type": "http",
      "url": "https://api.almirant.ai/mcp",
      "headers": {
        "Authorization": "Bearer <tu-api-key>"
      }
    }
  }
}

Portée par projet

Pour limiter les opérations à un projet précis, ajoutez le paramètre projectId à l'URL. Consultez Portée par projet pour plus de détails.

Configuration dans Cursor

Cursor prend en charge MCP de manière native. Ajoutez la configuration dans le fichier de paramètres MCP de Cursor (.cursor/mcp.json) :

{
  "mcpServers": {
    "almirant": {
      "type": "http",
      "url": "https://api.almirant.ai/mcp",
      "headers": {
        "Authorization": "Bearer <tu-api-key>"
      }
    }
  }
}

Configuration globale (tous les projets)

Si vous préférez qu'Almirant soit disponible dans tous vos projets sans créer de .mcp.json dans chacun, ajoutez la configuration dans ~/.claude/settings.json :

{
  "mcpServers": {
    "almirant": {
      "type": "http",
      "url": "https://api.almirant.ai/mcp",
      "headers": {
        "Authorization": "Bearer <tu-api-key>"
      }
    }
  }
}

Erreurs d'authentification courantes

Code	Message	Cause	Solution
401	Unauthorized	Clé API absente ou invalide	Vérifiez que l'en-tête Authorization inclut Bearer <api-key>
401	API key expired	La clé API a été révoquée	Générez une nouvelle clé API dans Settings
403	Forbidden	La clé API ne dispose pas des autorisations pour la ressource demandée	Vérifiez les autorisations de la clé API
500	Error: could not resolve organizationId from API key	La clé API n'est pas associée à une organisation	Générez une nouvelle clé API depuis la bonne organisation

Vérifier la connexion

Une fois la configuration effectuée, vous pouvez vérifier que la connexion fonctionne à l'aide du tool get_current_user :

{
  "tool": "get_current_user"
}

Ce tool renvoie le profil de l'utilisateur authentifié, y compris id, name, email et organizationId. Si l'authentification échoue, vous recevrez une erreur descriptive.