Ga naar de hoofdinhoud

Stel OpenCode in voor Kanera MCP

OpenCode maakt verbinding met Kanera via de Modelcontextprotocol. Het ondersteunt automatische OAuth-detectie en dynamische clientregistratie voor externe MCP-servers, dus er is geen vooraf geregistreerde client of API-sleutel vereist.

Voeg Kanera toe aan uw OpenCode-configuratie:

{
  "$schema": "https://opencode.ai/config.json",
  "mcp": {
    "kanera": {
      "type": "remote",
      "url": "https://mcp.kanera.app/mcp",
      "enabled": true
    }
  }
}

OpenCode start OAuth automatisch wanneer Kanera voor het eerst authenticatie nodig heeft. U kunt de browserflow ook expliciet starten:

opencode mcp auth kanera

Meld u aan bij Kanera, bekijk de gevraagde toegang en kies Toegang toestaan. Rennen opencode mcp list om de verbinding te controleren. Als detectie of authenticatie mislukt, gebruik dan opencode mcp debug kanera om de stroom te inspecteren.

Zie Sluit een AI-agent aan voor bereiken en het loskoppelen van een agent.

Installeer de Kanera-vaardigheid​

De MCP-verbinding geeft OpenCode toegang tot de tools van Kanera. De optionele Kanera-agentvaardigheid leert het om namen om te zetten in stabiele ID's, de live-status te lezen voordat werk wordt gerapporteerd of gewijzigd, voltooid werk te onderscheiden van creatie-activiteit, idempotentiesleutels te gebruiken en veilig om te gaan met toestemmings- of snelheidslimietfouten.

Installeer de vaardigheid globaal met het open Agent Skills-installatieprogramma:

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

Voor een handmatige installatie downloadt u het volledige kanera vaardighedenmap en plaats deze op een van deze locaties:

  • ~/.agents/skills/kanera/ of ~/.config/opencode/skills/kanera/ voor een persoonlijke vaardigheid die beschikbaar is in projecten.
  • .agents/skills/kanera/ of .opencode/skills/kanera/ in een repository om de vaardigheid met dat project te delen.

OpenCode geeft de vaardigheid weer aan zijn agenten en laadt de volledige instructies indien relevant. Als u tools of vaardigheden beperkt via OpenCode-machtigingen, zorg er dan voor dat de skill gereedschap en de kanera_* MCP-tools worden niet geweigerd.

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 OpenCode-versie kan de externe OAuth-stroom niet voltooien.
  • 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. :::

Verwijs naar een omgevingsvariabele in plaats van de sleutel op te slaan in de configuratie:

{
  "$schema": "https://opencode.ai/config.json",
  "mcp": {
    "kanera": {
      "type": "remote",
      "url": "https://mcp.kanera.app/mcp",
      "oauth": false,
      "headers": {
        "Authorization": "Bearer {env:KANERA_API_KEY}"
      }
    }
  }
}

Maak een persoonlijke sleutel aan Profielinstellingen -> API-sleutels of een werkruimte die wordt ingetoetst Werkruimte-instellingen -> API.

Klantreferentie​