Ga naar de hoofdinhoud

Claude instellen voor Kanera MCP

Claude op internet, Claude Desktop en Claude Code kunnen verbinding maken met Kanera via de Modelcontextprotocol.

Claude en Claude Desktop: maak verbinding met OAuth​

Kanera is een gepubliceerde Claude-connector. Zoek naar Kanera onder Aanpassen -> Connectoren en selecteer Verbinden. Claude opent een browseraanmeldings- en toestemmingsscherm; u maakt of plakt geen API-sleutel. Het werkt op elk gehost Kanera-abonnement, inclusief Free.

Als de gepubliceerde connector niet zichtbaar is voor het huidige account of de huidige werkruimte, voegt u hetzelfde productie-eindpunt toe als een aangepaste connector:

  1. Openen Aanpassen -> Connectoren.

  2. Selecteer + -> Aangepaste connector toevoegen.

  3. Voer het MCP-adres van Kanera in:

    https://mcp.kanera.app/mcp

  4. Selecteer Toevoegen, dan Verbinden.

Voor een team- of ondernemingsorganisatie die connectoren beperkt, moet een eigenaar of primaire eigenaar mogelijk Kanera inschakelen onder Organisatie-instellingen -> Connectors voordat leden er verbinding mee kunnen maken.

Claude opent een Kanera-tabblad. Meld u aan, bekijk wat de agent kan doen en maak uw keuze Toegang toestaan. Schakel Kanera in voor een gesprek vanuit de + -> Connectoren menu naast de componist.

Beheer of ontkoppel de agent later Profielinstellingen -> API-sleutels. Zie Sluit een AI-agent aan voor details. Als OAuth geen optie is, zie de sleuteluitzondering API hieronder.

Claude Code: maak verbinding met OAuth​

Wanneer Claude Code is aangemeld met hetzelfde Claude-account, voert u deze eerst uit claude mcp list. Als de gepubliceerde Kanera-connector al aanwezig is, start u Claude Code en voert u deze in /mcpen verbind of authenticeer het daar. Voeg geen dubbele server toe.

Als Kanera niet aanwezig is, voeg dan de gehoste server voor uw gebruiker toe, zodat deze beschikbaar is voor alle projecten:

claude mcp add --transport http kanera --scope user https://mcp.kanera.app/mcp

Start Claude Code en ga naar binnen /mcp. Selecteer Kanera en voltooi de browserauthenticatiestroom. Rennen claude mcp list om het rapport te bevestigen Verbonden.

Terugval uitsluitend voor Shell​

Als een agent shell-opdrachten kan uitvoeren maar MCP niet kan gebruiken, installeer dan de Kanera CLI in plaats van de webinterface te automatiseren:

npx -y @kanera/cli commands          # inspect it without a global install
npm install --global @kanera/cli     # persistent command; requires Node 22+
kanera auth login
kanera setup claude --global
kanera whoami --json

De CLI geeft dezelfde Kanera-toollaag weer. kanera auth login logt in via uw browser met OAuth, op dezelfde manier als de connector, dus u hoeft geen sleutel aan te maken; gebruik --with-api-key voor een onbemande agent. Geef de voorkeur aan de gepubliceerde connector wanneer deze beschikbaar is, omdat deze niet hoeft te worden geïnstalleerd.

Installeer de Kanera-vaardigheid​

De MCP-verbinding geeft Claude toegang tot de tools van Kanera. De optionele Kanera-agentvaardigheid leert het namen om te zetten in stabiele ID's, de huidige status te lezen voordat werk wordt gerapporteerd of gewijzigd, idempotentiesleutels te gebruiken en fouten veilig af te handelen.

npx -y skills add https://github.com/happendev/Kanera/tree/main/integrations/skills/kanera --yes --global

Start Claude opnieuw op als de vaardigheid niet verschijnt. Claude kan het automatisch laden voor relevant werk, of je kunt het expliciet aanroepen.

Uitzondering: verbinden met een API-sleutel​

:::let op Gebruik OAuth wanneer u maar kunt Een API-sleutel is een langlevend geheim dat u zelf opslaat en roteert, en werk dat met een persoonlijke sleutel wordt gedaan, wordt geregistreerd als u, zonder de via <agent> etiket. Gebruik er alleen een als OAuth echt niet kan werken:

  • Uw Claude-installatie kan de gepubliceerde connector of een aangepaste connector met OAuth niet gebruiken.
  • Je hebt een lokale stdio-server nodig en kunt de Kanera CLI. kanera auth login meldt zich aan met OAuth, en kanera mcp bedient stdio met die aanmelding, geen sleutel vereist.
  • De machine heeft geen browser voor aanmelding. Probeer autorisatie van het apparaat eerst als uw klant dit ondersteunt.

Wanneer u een sleutel gebruikt, maakt u deze aan Alleen-lezen tenzij de agent het werk moet veranderen en het in een omgevingsvariabele moet bewaren in plaats van in een vastgelegd bestand. :::

Vervangen kanera_live_... met een persoonlijke sleutel van Profielinstellingen -> API-sleutels of een werkruimtesleutel van Werkruimte-instellingen -> API. Voor een persoonlijke Claude-opstelling is een persoonlijke sleutel meestal de juiste oplossing, omdat deze uw eigen boardtoegang tot alle werkruimten volgt.

Werkruimte API-instellingen waar een werkruimte API-sleutel kan worden gemaakt voor Kanera MCP.

Claude Code​

Voor het gehoste HTTP-eindpunt met een statische sleutel:

claude mcp add --transport http kanera --scope user https://mcp.kanera.app/mcp \
  --header "Authorization: Bearer kanera_live_..."

Voor een lokale stdio-server voert u de Kanera CLI als de server:

claude mcp add kanera --scope user \
  --env KANERA_API_KEY=kanera_live_... \
  --env KANERA_PUBLIC_API_URL=https://api.kanera.app \
  -- npx -y @kanera/cli mcp

Als je al hebt gerend kanera auth login, laat beide vallen --env vlaggen; kanera mcp hergebruikt de opgeslagen referentie. Rennen claude mcp list om te bevestigen dat de server is verbonden.

Claude Bureaublad​

Openen Instellingen -> Ontwikkelaar -> Configuratie bewerken, die opent claude_desktop_config.jsonen voeg de server toe onder mcpServers:

{
  "mcpServers": {
    "kanera": {
      "command": "npx",
      "args": ["-y", "@kanera/cli", "mcp"],
      "env": {
        "KANERA_API_KEY": "kanera_live_...",
        "KANERA_PUBLIC_API_URL": "https://api.kanera.app"
      }
    }
  }
}

Start Claude Desktop opnieuw op nadat u het hebt opgeslagen, open vervolgens een nieuw gesprek en controleer of de Kanera-tools beschikbaar zijn. Deze configuratie voert de server lokaal uit via stdio en heeft knooppunt 22 of hoger nodig.

Als u Kanera al in Claude Desktop hebt geconfigureerd en Claude Code later installeert, kan Claude Code de desktopconfiguratie importeren met:

claude mcp add-from-claude-desktop

Deze importopdracht is beschikbaar op macOS en Windows Subsystem for Linux (WSL).

Referenties van klanten​