MCP technische referentie

Gebruik deze pagina als u transportgegevens, statische referenties, capaciteitsgrenzen of protocolprobleemoplossing nodig heeft. Voor de kortste persoonlijke configuratie begint u met Verbind Kanera met uw AI-agent.

Verbindingsmethoden

Verbinding	Authenticatie	Effectieve toegang
Interactieve OAuth	Browseraanmelding en toestemming	Fungeert als de verbonden gebruiker met de mogelijkheid tot lezen en schrijven. De klant controleert de beschikbaarheid en goedkeuring van acties; Kanera dwingt de bestuursrol van de gebruiker af. Het krijgt nooit toegang tot de werkruimtebeheer.
Apparaatautorisatie	Een korte gebruikerscode die is goedgekeurd in een browser op elk apparaat	Fungeert als de goedkeurende gebruiker, precies zoals interactieve OAuth. Het krijgt nooit toegang tot de werkruimtebeheer.
Onbeheerde agent	OAuth client_credentials	Maakt gebruik van een werkruimteservice-identiteit met een maximum van Lezen, Schrijven of Beheerder, gekozen door een beheerder. De beheerder voegt momenteel geen tools toe aan de standaard MCP-server; gebruik een aparte werkruimte of bord API-sleutel voor direct REST-beheer.
Persoonlijke API-sleutel	Statisch token aan toonder	Treedt op als eigenaar op toegankelijke borden. Het standaard MCP blijft werkgericht; directe REST-aanvragen nemen afzonderlijk de ondersteunde machtigingen van de eigenaar over.
Werkruimte of bord API-sleutel	Statisch token aan toonder	Blijft vastgemaakt aan de standaardwerkruimte of het zelfstandige bord en het lees-, schrijf- of beheerdersbereik. De beheerder voegt geen configuratietools toe aan de standaard MCP.

Zie Sluit een AI-agent aan voor interactieve OAuth, toestemming, intrekking, onbeheerde agenten en de autorisatiestroom.

Gehoste eindpunten

Het gehoste MCP-eindpunt van Kanera is:

https://mcp.kanera.app/mcp

De servicestatuscheck is:

https://mcp.kanera.app/health

OAuth-compatibele clients kunnen het MCP-eindpunt rechtstreeks toevoegen en de authenticatie in de browser voltooien. Een client die een API-sleutel gebruikt, verzendt deze als een dragertoken:

Authorization: Bearer kanera_live_...

Als jouw team Kanera op zijn eigen adres runt, hetzelfde /mcp en /health paden zijn daar van toepassing. Kopieer het exacte MCP-adres dat hieronder wordt weergegeven Profielinstellingen -> API-sleutels in die Kanera.

Protocolversies

Het gehoste eindpunt bedient zowel het huidige MCP-protocol als de eerdere revisies die Claude, Codex, Cursor, Copilot, Gemini CLI en OpenCode tegenwoordig gebruiken, vanaf dezelfde server. Oudere klanten zien dezelfde tools, bronnen en aanwijzingen als voorheen; klanten op het huidige protocol krijgen ook abonnementen op evenementen. Toolschema's worden voor beide in hetzelfde JSON Schema-dialect gepubliceerd, zodat geen enkele klant een ander contract ziet. kanera mcp over stdio accepteert beide ook.

OAuth-tokenveiligheid

OAuth-compatibele clients verwerken de beveiligingsgegevens automatisch. Het token dat wordt uitgegeven voor een Kanera-verbinding werkt alleen met het MCP-adres dat door Kanera wordt weergegeven; het kan niet worden hergebruikt als een algemene openbare API-referentie.

Als u een aangepaste OAuth-client bouwt, verzendt u dat exacte MCP-adres als resource tijdens autorisatie en elke tokenuitwisseling. De onderstaande voorbeelden van apparaatautorisatie laten zien waar dit thuishoort. Gebruik een persoonlijke, werkruimte- of bord-API-sleutel voor een integratie die de REST API rechtstreeks aanroept.

Apparaatautorisatie voor CLI en headless clients

Een client die geen browseromleiding kan ontvangen, zoals een terminaltool, een SSH-sessie of een machine zonder bruikbare browser, kan verbinding maken met de OAuth-apparaatautorisatietoekenning (RFC 8628). De client toont een korte code, iemand keurt deze goed in een browser op elk apparaat en de client peilt totdat hij tokens ontvangt.

Het resultaat is dezelfde identiteit als interactieve OAuth. De verbinding fungeert als de goedkeurende gebruiker met de mogelijkheid tot lezen en schrijven, terwijl Kanera de rol van die gebruiker op elk bord blijft afdwingen. Het krijgt nooit toegang tot de werkruimtebeheer. Voor het goedkeuren van een apparaatverzoek is een plan nodig dat agentverbindingen toestaat, dezelfde vereiste als voor elke andere agentverbinding.

Kanera maakt reclame voor de instroom /.well-known/oauth-authorization-server:

Metagegevensveld	Waarde
device_authorization_endpoint	https://api.kanera.app/oauth/device/code
grant_types_supported	Inclusief urn:ietf:params:oauth:grant-type:device_code

Registreer een apparaatclient

Schrijf de klant in via /oauth/register met het apparaattoekenningstype. Een client die alleen op apparaten werkt, heeft geen omleidings-URI nodig; redirect_uris is alleen nodig als de klant ook gebruikt authorization_code.

curl -X POST https://api.kanera.app/oauth/register \
  -H 'content-type: application/json' \
  -d '{
    "client_name": "Acme CLI",
    "grant_types": ["urn:ietf:params:oauth:grant-type:device_code", "refresh_token"]
  }'

Kanera wijst de apparaatstroom af voor elke client die niet is geregistreerd met het apparaattoekenningstype.

Vraag een apparaatcode aan

curl -X POST https://api.kanera.app/oauth/device/code \
  -d client_id=kanera_client_... \
  -d resource=https://mcp.kanera.app/mcp \
  -d 'scope=kanera:read kanera:write offline_access'

resource is vereist en moet overeenkomen met het adres MCP. Kanera normaliseert elk door de gebruiker geautoriseerd apparaatverzoek naar kanera:read kanera:write, inclusief klanten die dit nalaten scope of vraag alleen Lezen. Kanera geeft een vernieuwingstoken uit wanneer de client het refresh_token soort subsidie; offline_access wordt geaccepteerd maar is niet vereist. Alleen kanera:read, kanera:write, en offline_access worden geaccepteerd.

Reactieveld	Betekenis
device_code	Het geheim dat de client terugstuurt bij het pollen.
user_code	De korte code die de persoon typt, opgemaakt als ABCD-2345.
verification_uri	De /oauth/device pagina op uw Kanera-webadres.
verification_uri_complete	Dezelfde pagina met de code vooraf ingevuld in de queryreeks.
expires_in	600. Het verzoek vervalt tien minuten nadat het is uitgegeven.
interval	5. Het minimumaantal seconden tussen peilingen.

Keur het verzoek goed

1. De cliënt toont de user_code en de verification_uri, of opent verification_uri_complete direct.
2. De persoon opent dat adres en meldt zich aan bij Kanera als dit nog niet het geval is.
3. De pagina geeft de client een naam, toont de code zodat deze kan worden gecontroleerd met de terminal en vermeldt wat de client kan doen.
4. Kiezen Toegang toestaan keurt de verbinding goed. Kiezen Ontkennen wijst het af.

Poll voor tokens

curl -X POST https://api.kanera.app/oauth/token \
  -d grant_type=urn:ietf:params:oauth:grant-type:device_code \
  -d device_code=kanera_device_... \
  -d client_id=kanera_client_... \
  -d resource=https://mcp.kanera.app/mcp

Poll niet sneller dan interval. Totdat de aanvraag is voltooid, keert het tokeneindpunt terug 400 met een standaard OAuth-fout:

Fout	Betekenis	Wat de cliënt moet doen
authorization_pending	Niemand heeft het verzoek nog goedgekeurd of afgewezen.	Blijf pollen met het huidige interval.
slow_down	De klant heeft sneller gepeild dan het interval.	Kanera voegt vijf seconden toe aan het interval. Gebruik vanaf nu het langere interval.
access_denied	De persoon heeft het verzoek afgewezen.	Stop met pollen en start een nieuw verzoek.
expired_token	De code is verlopen of de tokens zijn al uitgegeven.	Start een nieuw verzoek.
invalid_grant	De apparaatcode is onbekend of behoort toe aan een andere client.	Start een nieuw verzoek.

Na goedkeuring retourneert het eindpunt dezelfde payload als elke andere subsidie: een doelgroepgebonden kanera_mcp_... toegangstoken geldig voor vijftien minuten, plus een vernieuwingstoken wanneer de client het heeft geregistreerd refresh_token soort subsidie. Een apparaatcode is voor eenmalig gebruik, dus een herhaalde uitwisseling komt terug expired_token. Vernieuwingsverzoeken moeten hetzelfde bevatten resource.

Beheer of trek een apparaatverbinding in waar elke andere agentverbinding wordt beheerd, onder Profielinstellingen -> API-sleutels.

Maak een API-sleutel

Gebruik API-sleutels voor lokale stdio, clients die alleen statische dragertokens accepteren, of aangepaste server-side-integraties.

Persoonlijke API-sleutel

1. Openen Profielinstellingen.
2. Ga naar API-sleutels.
3. Maak een persoonlijke API-sleutel aan.
4. Kies Alleen-lezen of Lezen en schrijven. Alleen-lezen is de juiste standaard voor een agent zonder toezicht: Kanera weigert elke mutatie bij de API, dus de toolrechten van de klant zijn niet het enige dat tussen een agent en uw werk staat. Een client die is verbonden met een alleen-lezen sleutel krijgt alleen de leeshulpmiddelen aangeboden en plant dus nooit een wijziging die hij niet kan doorvoeren.
5. Voeg optioneel een privélabel toe dat de klant identificeert.
6. Kopieer het geheim wanneer het wordt weergegeven.

Een persoonlijke sleutel heeft een voorvoegsel zoals kanera_u_live_.... Het wordt één keer getoond en fungeert als eigenaar, begrensd door de door u gekozen reikwijdte. Bewaar het alleen in het inloggegevensarchief van de AI-client of in de geheime manager van uw server.

Werkruimte of bord API-sleutel

1. Open de standaardwerkruimte of het zelfstandige bord.
2. Ga naar Instellingen -> API.
3. Maak een API-sleutel.
4. Kies de kleinste scope die bij de workflow past.
5. Kopieer het geheim wanneer het wordt weergegeven.

Reikwijdte	Subsidies
Lees	Inspecteer, zoek, vat samen en rapporteer zonder Kanera te wijzigen.
Schrijf	Creëer en update bordinhoud, inclusief kaarten, checklists, opmerkingen, opdrachten, labels, aangepaste veldwaarden en notities.
Beheerder	Voer ondersteund direct openbaar API-beheer uit. De standaard MCP-server blijft werkgericht en biedt geen beheertools voor werkruimte, bord, lijst, label, veld, optie, retentie of bestelling.

Sluit een lokale stdio-client aan

De eenvoudigste lokale stdio-server is de Kanera CLI. Installeer het, log een keer in en wijs de client aan kanera mcp; het bedient dezelfde toollaag over stdio met behulp van de opgeslagen referentie, dus er is geen tweede sleutel om op een tweede plaats te configureren.

npm install --global @kanera/cli
kanera auth login

{
  "mcpServers": {
    "kanera": {
      "command": "kanera",
      "args": ["mcp"]
    }
  }
}

Gebruik npx @kanera/cli mcp in plaats van een globale installatie als u liever niets installeert, en toevoegt "args": ["mcp", "--profile", "agent"] om een benoemd profiel te kiezen.

Om de inloggegevens via de omgeving te leveren in plaats van via een opgeslagen profiel – de gebruikelijke keuze in CI of een sandbox-agent – lezen zowel de CLI als het zelfstandige MCP-pakket:

Omgevingsvariabele	Doel
KANERA_API_KEY	Een persoonlijke API-sleutel, werkruimte- of board-API-sleutel.
KANERA_PUBLIC_API_URL	De oorsprong van de openbare API van Kanera, zoals https://api.kanera.app.

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

Gebruik het gehoste HTTP-eindpunt als u het MCP-proces helemaal niet lokaal hoeft uit te voeren.

Hulpbronnen

Kanera biedt vier gestructureerde JSON-resourcesjablonen:

Bron	URI	Bevat
Standaard werkruimte	kanera://workspace/{workspaceId}	Gelimiteerde werkruimteconfiguratie en gedeelde lijsten, labels, velden, sjablonen, automatiseringen en lidmaatschap zichtbaar voor de inloggegevens
Bord	kanera://board/{boardId}	Gelimiteerde metadata en zichtbare configuratie voor een standaardwerkruimte of een zelfstandig bord, zonder kaarten
Kaart	kanera://card/{cardId}	Kaartgegevens, inclusief labels, verantwoordelijken, checklists, bijlagen en gekoppelde notities
Let op	kanera://note/{noteId}	Een zichtbare persoonlijke of teamnotitie

Persoonlijke notities zijn privé voor de verbonden gebruiker. Impliceer niet dat een ander werkruimtelid of een werkruimteservicereferentie deze kan lezen.

Kaartreferenties

MCP-kaartvelden genoemd cardId of cardIds accepteer een van deze referenties:

• Een menselijke kaartsleutel zoals PROJ-123, inclusief een exacte sleutel die een eerder werkruimtevoorvoegsel gebruikt.
• Een canonieke Kanera-kaart-URL.
• De kaart-UUID die wordt geretourneerd door de openbare API.

Gebruik de menselijke sleutel in aanwijzingen en gebruikersgerichte antwoorden. Kanera lost dit op naar de UUID voordat de bestaande openbare API-bewerking wordt aangeroepen, zodat autorisatie, activiteit en auditgedrag hetzelfde blijven. Een opgeloste sleutel wordt een paar minuten onthouden voor de verbinding, dus als u deze herhaalt voor een taak die uit meerdere stappen bestaat, wordt de zoekopdracht niet herhaald. Als de verbonden gebruiker dezelfde sleutel in meer dan één organisatie kan zien, gebruik dan de canonieke kaart-URL om de beoogde organisatie ondubbelzinnig te identificeren.

Kaartresultaten omvatten de huidige voor mensen leesbare sleutel. De kanera://card/{cardId} resource-URI blijft de UUID gebruiken; menselijke sleutels en koppelingen zijn van toepassing op MCP-toolinvoer.

Capaciteitsgroepen

De live toolschema's zijn de autoriteit voor namen, invoer, veiligheidsannotaties en limieten. De server omvat momenteel:

Gebied	Beschikbare bewerkingen
Ontdekking	Inspecteer de acteersessie, pagina standaardwerkruimten en toegankelijke borden, lees de begrensde werkruimte of bordconfiguratie, en paginaborden en leden
Configuratiegrens	Lees lijsten, labels, velden, opties, leden en machtigingen die nodig zijn om doelgericht werk te doen. Maken, bewerken, opnieuw rangschikken, bewaren en andere beheerbewerkingen voor lijsten/werkruimten blijven in de Kanera-interface en zijn geen MCP-tools
Zoeken	Zoek live kaarten, notities, opmerkingen en bestandsnamen van bijlagen, of doorzoek de officiële Kanera-documentatie
Kaarten	Samenvattingen of volledige inhoud lezen, begrensde checklist/commentaarinhoud ophalen voor maximaal 200 geselecteerde kaarten, bijlagen en omslagen maken, bijwerken, verplaatsen, opnieuw ordenen, kopiëren, verplaatsen tussen compatibele borden, archiveren, uit het archief halen, voltooien, opnieuw openen en beheren
Kaartrelaties	Lees individuele links met cards.get, verken ketens met cards.dependency_graphen toevoegen of verwijderen blocks, blocked_by, of relates_to koppelingen met cards.set_relations
Bijlagen	Lees de inhoud van een bijlage met cards.get_attachment (afbeeldingen als afbeeldingen, tekstbestanden als paginatekst); voeg een bestand toe vanaf de eigen schijf van de agent cards.create_upload_link, die een eenmalige URL retourneert waarnaar de agent uploadt curl -T
Bordscheiders	Maak getitelde, optioneel gekleurde scheidingstekens; hun uiterlijk bijwerken; verplaats ze ten opzichte van kaarten, scheidingstekens of lijstranden; plaats kaarten ten opzichte van scheidingstekens; en verwijder scheidingstekens zonder kaarten te wisselen
Bulkkaartwerk	Aangepaste velden op geselecteerde kaarten voltooien, dateren, labelen, toewijzen, verplaatsen, archiveren, kopiëren of instellen, waarbij batchlimieten op bordniveau in elk schema worden weergegeven
Opdrachten en velden	Vervang toegewezen personen of labels en stel ondersteunde aangepaste veldwaarden in of wis deze
Opmerkingen	Pagina, voeg optionele bijlagen toe, bewerk, verwijder een in aanmerking komende reactie en voeg idempotent reacties toe of verwijder deze
Controlelijsten	Lees de checklists van een kaart als een geneste boom met ID's; maak een checklist samen met de items, verantwoordelijken, vervaldata en één niveau van subchecklists in één atomaire oproep; een of meer items toevoegen op een gekozen positie; een of meer artikelen bijwerken met verschillende wijzigingen per artikel; stel één verantwoordelijke of vervaldatum in voor elk item; hernoemen, opnieuw ordenen, verplaatsen en verwijderen. Batches worden volledig gevalideerd voordat er iets wordt geschreven, en fouten benoemen het exacte veld
Volgende prioriteiten	Ontdek leesbare persoonlijke wachtrijen en wachtrijen voor teamgenoten, lees de exacte rangorde en voeg toegewezen actieve kaarten toe, verplaats of verwijder deze wanneer de referentie- en werkruimte-autoriteit dit toestaan
Agent vlucht	Kondig werk tijdens de vlucht aan op een kaart met runs.start, rapporteer voortgang en hartslag met runs.update, sluit de run af met een terminalstatus en controleer waarmee al wordt uitgevoerd runs.list
Werk en rapportage	Query's met begrensde persoonlijke of zichtbare teamkaarten met achterstallige, niet-toegewezen, inactieve en laatst verplaatste filters; lees de hele dag van de aangesloten gebruiker in één gesprek met work.my_day; inspecteer tijdlijnschema's en cross-board rollups met work.portfolio_summary; en genereer persoonlijk bewijsmateriaal op toegankelijke borden
Activiteit en voltooid werk	Paginabordactiviteit en kaartgeschiedenis, en voltooiingsgeschiedenis en uitgevoerde werkzaamheden lezen
Notities	Metagegevens van pagina's noteren, volledige inhoud lezen, persoonlijke of teamnotities maken, bijwerken, koppelen, kleine bestanden bijvoegen, kopiëren en opnieuw ordenen
Kladblok	Leg 'herinner mij eraan...'-items vast in uw privé-omgeving Kladblok Inbox zonder een bord te kiezen, pagina's weergeven en lezen, en items afvinken. Vereist een browseraanmelding of persoonlijke sleutel

Zie de gegenereerde MCP gereedschapsinventaris voor elke geregistreerde gereedschapsnaam.

Kaartrelaties

cards.get inclusief de kaart relations en hiddenBlockerCount. cards.set_relations voegt relaties toe of verwijdert ze in dezelfde werkruimte:

{
  "cardId": "WEB-18",
  "direction": "blocked_by",
  "otherCardIds": ["MKT-42", "MKT-43"],
  "remove": false
}

direction is blocks, blocked_by, of relates_to, lees van cardId's kant. otherCardIds accepteert één kaartreferentie of maximaal 50; remove standaard ingesteld op false. Toevoegingen zijn idempotent en committen per doel. Een gedeeltelijk succes keert terug failed inzendingen en eventuele notAttemptedCardIds naast de resulterende relaties. Als de laatste lezing mislukt, addedCardIds en relationsUnavailable rapporteer wat er is opgeslagen. De oproepfouten wanneer elke wijzigingspoging wordt geweigerd. Verwijderingsverplichtingen ook per doel: removedCardIds behoudt succesvolle verwijderingen naast alle failed, notAttemptedCardIds, of relationsUnavailable details. notFoundCardIds benoemt relaties die het niet kan zien of vinden; die worden met rust gelaten.

Voor een inloggegevens die schrijfbaar zijn, is bewerkingstoegang vereist cardId en elke kaart die geblokkeerd raakt, en leestoegang tot de andere kaarten. Cycli, zelfkoppelingen, koppelingen tussen werkruimten en voltooide kaarten als nieuwe blokkers worden afgewezen. Lezen laat ontoegankelijke kaartgegevens weg, maar telt verborgen actieve blokkers. Gebruik filters: { blockedOnly: true } met work.query_cards voor geblokkeerde open kaarten, of atRiskOnly: true voor open kaarten waarvan de zichtbare blokkeerder te laat is of erna komt; work.portfolio_summary rapporteert beide tellingen; abonneer je op card.blocked en card.unblocked voor overgangen. Deze gebeurtenissen werken onafhankelijk van geconfigureerde automatiseringen.

Bij voltooiing via MCP wordt geen interactieve waarschuwing voor geblokkeerd werk weergegeven. Lees eerst de relaties om te beslissen of het werk gereed is. Een geblokkeerde agentuitvoering (runs.update met status: "blocked") beschrijft die run en creëert geen kaartafhankelijkheid. Zie Kaartrelaties en blokkering.

Afhankelijkheidsgrafieken

cards.dependency_graph geeft antwoord op wat een kaart blokkeert, wat deze vasthoudt en welk werk met elkaar verbonden is via een bord of werkruimte. Passeer precies één van cardId (sleutel, UUID of canonieke URL), boardId, of workspaceId:

{ "cardId": "MKT-42" }

De tool keert uitgebreid terug cards, edges, en truncated. Kaarten bevatten hun sleutel, titel, URL, bronbord-/lijstnamen, inScopeen beschikbare datums, labels en toegewezen personen. openBlockerCount bevat actieve blokkers die de beller niet kan zien; offMapBlockerCount telt actieve blokkers die afwezig zijn op deze kaart. Alleen aanwezige, niet-nul optionele waarden zijn opgenomen. EEN blocks rand loopt van sourceCardId naar targetCardId.

Er komt ook een kaartscope terug focus: blockedBy en blocks zijn directe verbindingen; upstream en downstream zijn transitieve kaart-ID's in de dichtstbijzijnde volgorde; relatedTo geeft contextuele links weer. onMap: false betekent dat de gevraagde kaart voltooid, gearchiveerd, niet gerelateerd of anderszins afwezig was in de grafiek. Afwezigheid is geen bewijs dat een kaart geen relaties heeft.

De grafiek volgt blokkerende links in beide richtingen via leesbare open kaarten. Er kunnen voltooide vereisten verschijnen, maar het doorlopen ervan gaat niet verder. Verborgen kaarten worden geteld zonder dat ze een naam krijgen of worden gebruikt als brug naar ander werk. Gerelateerde buren zijn één hop uit de open zaden van de scope inbegrepen. De respons stopt bij 400 kaarten en sets truncated; verklein de reikwijdte voor meer details. Dit is een leeshulpmiddel. Gebruik cards.set_relations om koppelingen te bewerken en afhankelijkheidsgebeurtenissen veranderingen te monitoren.

Datums

Datuminvoer accepteert YYYY-MM-DD of alledaagse zinnen, opgelost in uw eigen tijdzone vanuit uw Kanera-profiel: today, tomorrow 1pm, friday (de volgende vrijdag, inclusief vandaag), next friday (een week daarna), in 2 weeks, next month, end of week, end of month, of oct 12. session.get retourneert uw timeZone en today zodat een agent je de datum kan laten zien waarop het is gelukt. Kanera vervaldatums gebruiken tijdslots in plaats van exacte tijden, dus een tijdstip kiest het overeenkomende slot: tot 09:00 uur is Ochtend, tot 13.00 uur Middag, tot 17.00 uur Einde werkdag, en alles later de hele dag. Een zin die Kanera niet kan lezen, wordt met de geaccepteerde formulieren geweigerd in plaats van geraden.

Resultaatvolgorde

In de beschrijving van elke lijsttool wordt de volgorde vermeld waarin de resultaten terugkomen, bijvoorbeeld 'nieuwste eerst' voor opmerkingen en activiteiten, weergavevolgorde voor lijsten en checklists, en snelste eerst voor work.query_cards standaard.

Tijdlijnschema's en startdata

Gebruik work.schedule met precies één boardId of workspaceId. Het leest dezelfde werkdagmotor als de Tijdlijnweergave, volgt toegankelijke, verbonden ketens over alle planken heen, en sluit voltooide en ontoegankelijke kaarten uit. Weergavefilters veranderen de berekening niet.

Resultaat	Betekenis
cards[].plannedStart, plannedEnd, durationDays	Het geplande datumbereik en de bijbehorende duur van maandag tot en met vrijdag.
earliestStart, earliestFinish, latestStart, latestFinish	Datums met beperkte afhankelijkheid en de laatste datums die de afwerking van de keten behouden.
slackDays, critical	Er is ruimte om te slippen tijdens werkdagen, en of er geen speling is in het verbonden werk. Null slack betekent dat de berekening geen datumanker heeft.
conflicts[]	Conflicterende open blokkers, met blockerId, edgeId, kind, en werkdag days.
criticalEdgeIds	Relaties op het kritieke planningspad.
summary	Gepland/ongepland, conflicten en kritieke tellingen, datumbereik, projectedFinish, latestDue, en werkdag slipDays tegen de laatste vervaldatum.

Pass startDateLocalDate naar cards.create, cards.update binnen changes, of elke invoer van cards.bulk_create. Gebruik YYYY-MM-DD of een ondersteunde zin met relatieve datum, opgelost in de gebruikerszone; null wist een bestaande start. Een start heeft geen tijdslot en kan niet later plaatsvinden. Voor deze schrijfbewerkingen is bewerkingstoegang vereist en worden de opvolgerdatums niet automatisch verplaatst.

Er is geen hypothetische planningsinvoer: stel een wijziging ten opzichte van de huidige planning voor, pas deze vervolgens toe en lees deze alleen opnieuw als een opgeslagen wijziging is bedoeld. Zie uitgewerkte planningsvoorbeelden en de payloads van evenementen plannen. Uitgeschakelde planningsfuncties keren terug TIMELINE_DISABLED of DEPENDENCIES_DISABLED voor operaties waarvoor ze nodig zijn.

Abonnementen op evenementen

Een client op het huidige MCP-protocol kan zich hierop abonneren card.created, card.updated, card.moved, en comment.created in een werkruimte, bord of kaart priorities.changed voor de eigen Up next-wachtrij van de verbonden gebruiker, en naar my_day.ready voor een briefing-ping op een doordeweekse ochtend, en ontvang elke gebeurtenis bij een geverifieerde HTTPS-callback die hij beheert. Abonnementen horen bij de verbinding, duren maximaal 24 uur per vernieuwing en worden vóór elke levering opnieuw gecontroleerd aan de hand van de huidige toegang van de identiteit. Zie Abonneer u op evenementen voor de catalogus, verificatie, ondertekening, nieuwe pogingen en foutcodes.

Ingebouwde aanwijzingen

Prompt	Gebruik
summarize_board_status	Inspecteer één bord en vat de voortgang, blokkades, oud werk en volgende acties samen.
prepare_standup_update	Combineer persoonlijk actueel werk en gepagineerde werkgeschiedenis op toegankelijke borden om een stand-up op te stellen.
draft_card_from_notes	Lees een notitie en stel een kaarttitel en Markdown-beschrijving op zonder de kaart te maken.

Normale gespreksprompts werken zelfs als een AI-client geen MCP-promptsjablonen beschikbaar stelt.

Beveiliging en destructieve operaties

• Interactieve en apparaatcode-OAuth verlenen altijd kanera:read en kanera:write; offline_access blijft optioneel. De MCP-client controleert de beschikbaarheid en goedkeuringen van tools, en Kanera dwingt bestuursrollen af. Beheertools werken alleen als de gebruiker de bijbehorende beheerdersrol heeft: organisatiebeheerders kunnen werkruimten en zelfstandige borden maken, en werkruimtebeheerders kunnen borden toevoegen en automatiseringen beheren.
• Elke OAuth-stroom bindt de autorisatie, code, vernieuwingsfamilie en toegangstoken aan de canonieke MCP resource.
• Rauw kanera_mcp_... toegangstokens worden alleen geaccepteerd door het MCP-eindpunt en worden afgewezen door /api/v1; de MCP-service gebruikt een afzonderlijke interne delegatiereferentie van minuten voor openbare API-oproepen.
• Apparaatautorisatie gebruikt dezelfde bereiken en dezelfde limieten. Een apparaatcode vervalt na tien minuten, kan één keer worden uitgewisseld en wordt alleen goedgekeurd door een ingelogde gebruiker die de door de klant getoonde code bevestigt.
• Onbeheerde agenten en werkruimtesleutels worden beperkt tot hun geconfigureerde bereik.
• Persoonlijke sleutels nemen de huidige machtigingen van de eigenaar over en moeten op dezelfde manier worden beschermd als het gebruikersaccount.
• API-sleutels met leesbereik en onbeheerde servicereferenties kunnen geen beveiligde mutaties aanroepen.
• API-sleutel- en MCP-activiteit wordt vastgelegd met de fungerende gebruikers- of integratie-identiteit. Een interactieve OAuth-agent wordt geregistreerd als de agent die namens zijn gebruiker optreedt: commentaar- en activiteitrijen bevatten de naam van de agent en worden weergegeven als via <agent>, en de gebruiker wordt op de hoogte gesteld van wat zijn agent heeft gedaan, in plaats van dat dit als eigen actie wordt onderdrukt. Een persoonlijke API-sleutel die door een script wordt gebruikt, fungeert nog steeds als eigenaar.
• Als u de verbinding met OAuth verbreekt of een onbeheerde agent verwijdert, worden de actieve inloggegevens ingetrokken.
• Gebruik een afzonderlijke inloggegevens per client, zodat de ene verbinding kan worden ingetrokken zonder dat dit gevolgen heeft voor de andere.

Kanera MCP kan het volgende niet verwijderen:

• Borden
• Lijsten
• Labels of aangepaste velden
• Notities
• Let op bijlagen

Verwijder deze handmatig in Kanera. MCP kan kaarten archiveren of dearchiveren en kan de actieve kaarten in een lijst archiveren.

Beheer via MCP is beperkt tot het maken van werkruimten en zelfstandige borden (organisatiebeheerders, met behulp van een interactieve OAuth-toekenning of een persoonlijke sleutel met schrijfmogelijkheid), het toevoegen van borden aan een werkruimte en het maken, bewerken, inschakelen en verwijderen van automatiseringen (werkruimtebeheerders). MCP kan werkruimten, borden, lijsten, labels, velden, opties, leden of bewaarinstellingen niet bewerken, opnieuw rangschikken of verwijderen. Deze bewerkingen blijven in de Kanera-interface; ondersteunde REST-eindpunten blijven beschikbaar voor doelbewust gebouwde integraties.

MCP kan permanent verwijderen:

• Een opmerking geschreven door de waarnemende gebruiker
• Een checklist en zijn items
• Een checklist-item

Deze gereedschapsschema's zijn als destructief gemarkeerd. Gebruik ze alleen na een expliciet verzoek en verifieer het doelwit voordat u ze belt.

Problemen oplossen

Probleem	Wat te controleren
De cliënt kan geen verbinding maken	Gebruik de exacte /mcp URL voor de Kanera waarmee u verbinding maakt, zoals hieronder weergegeven Profielinstellingen -> API-sleutels.
De client vraagt om een token in plaats van Kanera te openen	Het ondersteunt geen externe MCP OAuth. Gebruik een API-sleutel of een ondersteunde client.
De client heeft geen browser waarnaar kan worden omgeleid	Gebruik autorisatie van het apparaat als de client dit ondersteunt, of een API-sleutel als dit niet het geval is.
De peilingen komen steeds terug slow_down	Poll niet sneller dan de interval geretourneerd met de apparaatcode en gebruik na elk het langere interval slow_down.
De apparaatpagina meldt een ongeldige of verlopen code	Codes duren tien minuten en werken één keer. Controleer de code, log eerst in en vraag vervolgens een nieuwe code aan bij de klant.
Het tokeneindpunt keert terug invalid_target	Stuur het exacte MCP-adres van Profielinstellingen -> API-sleutels als resource tijdens autorisatie en elke tokenuitwisseling.
Er wordt gemeld dat de API-sleutel ontbreekt	Instellen KANERA_API_KEY voor stdio of verzenden Authorization: Bearer ... via HTTP.
Er komt een verzoek terug 401	De referentie ontbreekt, is verkeerd opgemaakt, verlopen, ingetrokken of onjuist gekopieerd. Start OAuth opnieuw of vervang de API-sleutel.
Er komt een verzoek terug 403	Voor persoonlijke OAuth bevestigt u dat de waarnemende gebruiker een redacteur is in plaats van een waarnemer op het doelbord. Voor een API-sleutel of onbemande agent moet u ook bevestigen dat de referentie geschikt is voor schrijven.
De agent kan lezen, maar niet bewerken	Sta de schrijfactie toe in de MCP-client en bevestig dat de acterende identiteit board-editortoegang heeft. Gebruik voor serviceverbindingen en API-sleutels ook een inloggegevens die geschikt zijn voor schrijven. Bestaande persoonlijke OAuth-verbindingen hoeven niet opnieuw verbinding te maken.
De agent kan geen bord vinden	Gebruik volledige borddetectie. Een bord kan op zichzelf staan ​​of alleen beschikbaar zijn via een expliciet gastlidmaatschap.
De agent kan geen werkruimte beheren	MCP omvat alleen het maken van werkruimten en borden en het beheren van automatiseringen, en alleen wanneer de waarnemende identiteit een beheerder is; werkruimtegerichte en alleen-lezen referenties kunnen geen werkruimten maken. Gebruik voor ander beheer de Kanera-interface of een ondersteund openbaar REST-eindpunt.
Een codeeragent beschikt over hulpmiddelen, maar gebruikt deze slecht	Installeer de ambtenaar Kanera-agentvaardigheid.
Nieuwe of gewijzigde tools verschijnen niet	Vernieuw of scan de MCP-server in de client opnieuw, zodat deze de huidige schema's ophaalt. Start de client opnieuw op als deze geen vernieuwingsactie heeft; OAuth-herautorisatie is normaal gesproken niet vereist.
De klant kan zich niet abonneren op evenementen	Evenementen hebben de gastheer nodig /mcp eindpunt en een client op het huidige MCP-protocol; een stdio kanera mcp server biedt ze nooit aan. Zie Abonneer u op evenementen voor callback- en scopefouten.

Gerelateerde pagina's

• Kanera CLI

• Verbind Kanera met uw AI-agent

• Maak verbinding met OAuth of een onbeheerde agent

• Voorbeelden van het gebruik van Kanera met AI

• Abonneer u op evenementen

• MCP-toolinventaris

• Openbare API