Ga naar de hoofdinhoud

Cursor instellen voor Kanera MCP

Cursor maakt verbinding met Kanera via de Modelcontextprotocol. Cursor ondersteunt externe Streamable HTTP-servers met OAuth, zodat u verbinding kunt maken via een browser zonder een API-sleutel aan te maken of op te slaan.

Installatie met één klik​

Als Cursor is geïnstalleerd, opent u deze link om Kanera in één stap toe te voegen aan Cursor:

Voeg Kanera toe aan de cursor

Cursor toont de server die hij gaat toevoegen (https://mcp.kanera.app/mcp) en vraagt u om dit te bevestigen. Voltooi vervolgens de hieronder beschreven browseraanmelding. Als de link Cursor niet opent, of als u Kanera zelf host, voeg dan de configuratie handmatig toe. De MCP-configuratiegenerator bouwt ook de link voor een zelf-gehost adres.

Handmatige configuratie​

Kanera toont deze configuratie, met uw MCP-adres ingevuld, onder Profielinstellingen -> API-sleutels -> Of configureer het handmatig -> Cursor.

Voeg Kanera toe aan uw algemene Cursor MCP-configuratie op ~/.cursor/mcp.json, of naar .cursor/mcp.json in een project wanneer de verbinding alleen daar beschikbaar zou moeten zijn:

{
  "mcpServers": {
    "kanera": {
      "url": "https://mcp.kanera.app/mcp"
    }
  }
}

Cursor detecteert dat Kanera OAuth vereist en vraagt u om te authenticeren. In Cursor Agent kunt u de browserstroom expliciet starten:

cursor-agent mcp login kanera

Meld u aan bij Kanera, bekijk de gevraagde toegang en kies Toegang toestaan. Controleer vervolgens de verbinding en beschikbare tools:

cursor-agent mcp list
cursor-agent mcp list-tools kanera

Open de Cursor-editor Instellingen -> Tools en MCP om de server en zijn tools te inspecteren. Zie Sluit een AI-agent aan voor bereiken en het loskoppelen van een agent.

Installeer de Kanera-vaardigheid​

De MCP-verbinding geeft Cursor 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 ~/.cursor/skills/kanera/ voor een persoonlijke vaardigheid die beschikbaar is in projecten.
  • .agents/skills/kanera/ of .cursor/skills/kanera/ in een repository om de vaardigheid met dat project te delen.

Start Cursor opnieuw als de vaardigheid niet verschijnt. Cursor kan het automatisch laden voor relevante verzoeken, of u kunt er een beroep op doen /kanera expliciet.

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 Cursor-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. :::

Lees de sleutel van een omgevingsvariabele in plaats van deze vast te leggen in een projectconfiguratie:

{
  "mcpServers": {
    "kanera": {
      "url": "https://mcp.kanera.app/mcp",
      "headers": {
        "Authorization": "Bearer ${env:KANERA_API_KEY}"
      }
    }
  }
}

Instellen KANERA_API_KEY in de omgeving waarin Cursor wordt gestart. Maak een persoonlijke sleutel aan Profielinstellingen -> API-sleutels of een werkruimte die wordt ingetoetst Werkruimte-instellingen -> API.

Klantreferentie​