MCP teknisk referanse

Bruk denne siden når du trenger transportdetaljer, statisk legitimasjon, kapasitetsgrenser eller feilsøking av protokoller. Koble Kanera til din AI-agent.

Tilkoblingsmetoder

Tilkobling	Autentisering	Effektiv tilgang
Interaktiv OAuth	Logg inn og samtykke	Fungerer som den tilkoblede brukeren med lese- og skriveverktøy. Klienten kontrollerer handlingstilgjengelighet og godkjenning; Kanera håndhever brukerens styrerolle. Den mottar aldri tilgang til arbeidsområdeadministrasjon.
Enhetsautorisasjon	En kort brukerkode godkjent i en nettleser på en hvilken som helst enhet	Fungerer som den godkjennende brukeren, akkurat som interaktiv OAuth. Den mottar aldri tilgang til arbeidsområdeadministrasjon.
Ubemannet agent	OAuth client_credentials	Bruker en arbeidsområdetjenesteidentitet som er begrenset til maksimumet for Les, Skriv eller Admin valgt av en administrator. Admin legger for øyeblikket ingen verktøy til standard MCP-server. Bruk en egen arbeidsområde- eller tavle-API-nøkkel for direkte REST-administrasjon.
Personlig API-nøkkel	Statisk bærer token	Fungerer som eier på tvers av tilgjengelige tavle. Standard MCP forblir arbeidsfokusert; direkte REST-forespørsler arver separat eierens støttede tillatelser.
Arbeidsområde eller API-nøkkel for tavle	Statisk bærer token	Holder fast til sitt standard arbeidsområde eller frittstående tavle og dets lese-, skrive- eller administratoromfang. Admin legger ikke til konfigurasjonsverktøy i standard MCP.

Se Koble til en AI-agent for interaktiv OAuth, samtykke, tilbakekalling, uovervåkede agenter og autorisasjonsflyten.

Vertsatte endepunkter

Kanera's vert MCP Endpoint er:

https://mcp.kanera.app/mcp

Helsekontrollen er:

https://mcp.kanera.app/health

OAuth-kompatible klienter kan legge til MCP-endepunktet direkte og fullføre godkjenning i nettleseren. En klient som bruker en API-nøkkel sender den som et bærertoken:

Authorization: Bearer kanera_live_...

Hvis teamet ditt kjører Kanera på sin egen adresse, det samme /mcp og /health Kopier den nøyaktige MCP-adressen som vises under Profilinnstillinger -> API-nøkler i det Kanera.

Protokollversjoner

Vertskapets endepunkt tjener både den gjeldende MCP-protokollen og de tidligere revisjonene som Claude, Codex, Cursor, Copilot, Gemini CLI og OpenCode bruker i dag, fra samme server. Eldre klienter ser de samme verktøyene, ressursene og spørringene som før; klienter på den gjeldende protokollen får også event abonnementer. Verktøyskjemaer publiseres i samme JSON Schema dialekt for begge, så ingen klient ser en annen kontrakt. kanera mcp Over Stdio aksepterer begge deler også.

OAuth token sikkerhet

OAuth-kompatible klienter håndterer sikkerhetsdetaljene automatisk. Tokenet som er utstedt for en Kanera-tilkobling fungerer bare med MCP-adressen som vises av Kanera. Det kan ikke gjenbrukes som en generell offentlig API-legitimasjon.

Hvis du bygger en egendefinert OAuth-klient, sender du den nøyaktige MCP-adressen som resource under autorisasjon og hver token utveksling. Eksemplene på enhetsautorisasjon nedenfor viser hvor den hører hjemme. Bruk en personlig, arbeidsområde eller tavle API-nøkkel for en integrasjon som kaller REST API direkte.

Enhetsautorisasjon for CLI og hodeløse klienter

En klient som ikke kan motta en nettleseromdirigering, for eksempel et terminalverktøy, en SSH-økt eller en maskin uten brukbar nettleser, kan koble til OAuth-enhetsautorisasjonstillatelsen (RFC 8628). Klienten viser en kort kode, en person godkjenner den i en nettleser på en hvilken som helst enhet, og klienten avstemninger til den mottar tokens.

Resultatet er den samme identiteten som interaktiv OAuth. Tilkoblingen fungerer som godkjennende bruker med lese- og skriveverktøy, mens Kanera fortsetter å håndheve brukerens rolle på hver tavle. Den mottar aldri tilgang til arbeidsområdeadministrasjon. Godkjenning av en enhetsforespørsel trenger en plan som tillater agenttilkoblinger, samme krav som enhver annen agentforbindelse.

Kanera annonserer flyten i /.well-known/oauth-authorization-server:

Metadatafelt	Verdi
device_authorization_endpoint	https://api.kanera.app/oauth/device/code
grant_types_supported	Inkluderer urn:ietf:params:oauth:grant-type:device_code

Registrere en enhetsklient

Registrer kunden i /oauth/register med enhetsbevilgningstypen. En enhetsklient trenger ikke en omdirigerings-URI; redirect_uris Dette gjelder også når kunden også 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 avviser enhetsflyten for enhver klient som ikke var registrert med enhetsbevilgningstypen.

Be om en enhetskode

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 er nødvendig og må samsvare med MCP-adressen. Kanera normaliserer hver brukerautorisert enhetsforespørsel til kanera:read kanera:writeinkludert kunder som ikke scope eller ber bare om Les. Kanera utsteder en oppdatering token når klienten registrerte refresh_token tilskuddstype, offline_access er akseptert, men ikke nødvendig. Bare kanera:read, kanera:write, og offline_access er akseptert.

Svarfelt	Betydning
device_code	Hemmeligheten klienten sender tilbake når avstemning.
user_code	Den korte koden personen typer, formatert som ABCD-2345.
verification_uri	Den /oauth/device siden på din Kanera-webadresse.
verification_uri_complete	Samme side med koden forhåndsutfylt i spørringsstrengen.
expires_in	600Forespørselen utløper ti minutter etter at den er utstedt.
interval	5. Minste antall sekunder mellom avstemninger.

Godkjenne forespørselen

1. Kunden viser user_code og den verification_urieller åpne verification_uri_complete direkte.
2. Personen åpner den adressen og logger inn på Kanera hvis de ikke allerede er det.
3. Siden navngir klienten, viser koden slik at den kan sjekkes mot terminalen, og lister opp hva klienten vil kunne gjøre.
4. Velge Tillat tilgang godkjenner tilkoblingen. Velge Nekte avviser det.

Poll for polletter

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

Ikke raskere enn interval. Inntil forespørselen er fullført, returnerer token-endepunktet 400 med en standard OAuth-feil:

Feil	Betydning	Hva kunden bør gjøre
authorization_pending	Ingen har godkjent eller avslått forespørselen ennå.	Fortsett å stemme med gjeldende intervall.
slow_down	Kunden spurte raskere enn intervallet.	Kanera legger til fem sekunder til intervallet. Bruk det lengre intervallet fra nå av.
access_denied	Personen avviste anmodningen.	Stopp avstemningen og start en ny forespørsel.
expired_token	Koden utløpt, eller tokens var allerede utstedt.	Start en ny forespørsel.
invalid_grant	Enhetskoden er ukjent eller tilhører en annen klient.	Start en ny forespørsel.

Etter godkjenning returnerer endepunktet samme nyttelast som alle andre tilskudd: et publikumsbundet kanera_mcp_... tilgangstoken gyldig i femten minutter, pluss en oppdateringstoken når klienten registrerte refresh_token En enhetskode er engangsbruk, så en gjentatt utveksling returnerer expired_token. Oppdater forespørsler må inneholde det samme resource.

Administrere eller tilbakekalle en enhetstilkobling der alle andre agenttilkoblinger administreres, under Profilinnstillinger -> API-nøkler.

Opprette en API-nøkkel

Bruk API-nøkler for lokale standard-klienter som bare godtar statiske bærertokener, eller tilpassede integrasjoner på serversiden.

Personlig API-nøkkel

1. Åpne Profilinnstillinger.
2. Gå til API-nøkler.
3. Opprett en personlig API-nøkkel.
4. Velg Skrivebeskyttet eller Les og skriv. Skrivebeskyttet er riktig standard for en uovervåket agent: Kanera nekter hver mutasjon på API, så klientens verktøytillatelser er ikke det eneste som står mellom en agent og arbeidet ditt. En klient som er koblet til en skrivebeskyttet nøkkel, tilbys bare leseverktøyene, slik at den aldri planlegger en endring den ikke kan gjøre.
5. Legg til en valgfri privat etikett som identifiserer klienten.
6. Kopier hemmeligheten når den vises.

En personlig nøkkel har et prefiks som kanera_u_live_.... Det vises en gang og fungerer som eier, avkortet av omfanget du valgte. Lagre det bare i AI-klientens legitimasjonsbutikk eller serverens hemmelige manager.

Arbeidsområde eller API-nøkkel for tavle

1. Åpne standard arbeidsområde eller frittstående tavle.
2. Gå til Innstillinger -> API.
3. Opprett en API-nøkkel.
4. Velg det minste området som passer til arbeidsflyten.
5. Kopier hemmeligheten når den vises.

Virkeområde	Tilskudd
Les	Inspisere, søke, oppsummere og rapportere uten å endre Kanera.
Skriv	Opprett og oppdater innhold på tavlen, inkludert kort, sjekklister, kommentarer, tildelinger, etiketter, egendefinerte feltverdier og notater.
Administrator	Utfør støttede direkte offentlig API-administrasjon. Standard MCP-server forblir arbeidsfokusert og eksponerer ingen arbeidsområde, tavle, liste, etikett, felt, alternativ, oppbevaring eller bestillingsadministrasjonsverktøy.

Koble til en lokal standardklient

Den enkleste lokale stdio-serveren er Kanera CLI. Installer den, logg inn en gang, og pek klienten på kanera mcp; det tjener det samme verktøylaget over stdio ved hjelp av den lagrede legitimasjonen, så det er ingen andre nøkkel å konfigurere på et andre sted.

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

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

Bruk npx @kanera/cli mcp i stedet for en global installasjon når du heller ikke vil installere noe, og legg til "args": ["mcp", "--profile", "agent"] Velg en navngitt profil.

For å levere legitimasjonen gjennom miljøet i stedet for en lagret profil - det vanlige valget i CI eller en sandkasse-agent - både CLI og den frittstående MCP-pakken leste:

Miljøvariabel	Formål
KANERA_API_KEY	En personlig, arbeidsområde eller tavle API-nøkkel.
KANERA_PUBLIC_API_URL	Kanera-offentlig API-opprinnelse, som 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"
      }
    }
  }
}

Bruk vertsbaserte HTTP-endepunkter når du ikke trenger å kjøre MCP-prosessen lokalt i det hele tatt.

Ressurser

Kanera tilbyr fire strukturerte JSON ressursmaler:

Ressurs	URI	Inneholder
Standard arbeidsområde	kanera://workspace/{workspaceId}	Grenset arbeidsområdekonfigurasjon og delte lister, etiketter, felt, maler, automatiseringer og medlemskap synlig for legitimasjonen
Tavle	kanera://board/{boardId}	Grenset metadata og synlig konfigurasjon for et standard arbeidsområde eller frittstående tavle, uten kort
Kort	kanera://card/{cardId}	Kortdetaljer, inkludert etiketter, oppdragsgivere, sjekklister, vedlegg og koblede notater
Merknad	kanera://note/{noteId}	Et synlig personlig notat eller et lagnotat

Personlige notater er private for den tilkoblede brukeren. Ikke antyd at et annet arbeidsområdemedlem eller en arbeidsområdetjeneste legitimasjon kan lese dem.

Kortreferanser

MCP- kortfelt med navn cardId eller cardIds godta noen av disse referansene:

• En menneskelig kortnøkkel som PROJ-123, inkludert en eksakt nøkkel som bruker et tidligere arbeidsområdeprefiks.
• En kanonisk Kanera-kort-URL.
• Kortet UUID returnert av det offentlige API.

Bruk den menneskelige nøkkelen i spørsmål og brukervendte svar. Kanera løser det til UUID før du ringer den eksisterende offentlige API-operasjonen, så autorisasjon, aktivitet og revisjonsadferd forblir den samme. En løst nøkkel huskes for tilkoblingen i noen minutter, så å gjenta den over en flertrinnsoppgave gjentar ikke oppslaget. Hvis den tilkoblede brukeren kan se den samme nøkkelen i mer enn én organisasjon, bruk den kanoniske kortadressen for å identifisere den entydige.

Kortresultatene inkluderer den gjeldende leselige nøkkelen. kanera://card/{cardId} ressurs-URI fortsetter å bruke UUID; menneskelige nøkler og koblinger gjelder for MCP-verktøyinnganger.

Kapasitetsgrupper

Live-verktøyskjemaene er autoriteten for navn, inndata, sikkerhetsanmerkninger og grenser. Serveren dekker for tiden:

Område	Tilgjengelige operasjoner
Discovery	Kontrollere den fungerende økten, siden standard arbeidsområder og tilgjengelige tavler, lese avgrenset arbeidsområde eller board konfigurasjon, og side boards og medlemmer
Innstillingsgrense	Leselister, etiketter, felt, alternativer, medlemmer og tillatelser som er nødvendige for å målrette arbeidet. Opprette, redigere, endre rekkefølge, oppbevaring og andre administrasjonsoperasjoner for liste/arbeidsområde forblir i Kanera-grensesnittet og er ikke MCP-verktøy
Søk	Søk etter levende kort, notater, kommentarer og vedlegg filnavn, eller søk i den offisielle Kanera dokumentasjon
Kort	Les sammendrag eller fullt innhold, hent begrenset sjekkliste / kommentarinnhold for opptil 200 utvalgte kort, opprett, oppdater, flytt, omorganiser, kopier, flytt mellom kompatible tavler, arkiver, fjern arkivering, fullfør, åpne og administrer vedlegg og deksler
Kortforhold	Les individuelle lenker med cards.getutforske kjeder med cards.dependency_graph, og legg til eller fjern blocks, blocked_by, eller relates_to Linker til cards.set_relations
Vedlegg	Lese innholdet i et vedlegg med cards.get_attachment (bilder som bilder, tekstfiler som sidetekst); legg ved en fil fra agentens egen disk med cards.create_upload_link, som returnerer en engangs URL agenten laster opp til med curl -T
tavlen separatorer	Opprette tittel-, eventuelt fargede skilletegn, oppdatere utseendet, flytte dem i forhold til kort, skilletegn eller listekanter, plassere kort i forhold til skilletegn og slette skilletegn uten å bytte kort
Bulk kort arbeid	Fullfør, dato, merke, tilordne, flytte, arkivere, kopiere eller angi egendefinerte felt på valgte kort, med gruppegrenser på brettnivå som er eksponert i hvert skjema
Oppdrag og felt	Erstatt oppdragsgivere eller etiketter og angi eller fjerne støttede egendefinerte feltverdier
Kommentarer	Side, legge til med valgfrie vedlegg, redigere, slette en kvalifisert kommentar, og idempotently legge til eller fjerne reaksjoner
Sjekklister	Les et korts sjekklister som et nestet tre med ID-er; opprett en sjekkliste sammen med sine elementer, oppdragsgivere, forfallsdatoer og ett nivå av undersjekklister i ett atomanrop; legg til ett eller flere elementer på en valgt posisjon; oppdater ett eller flere elementer med forskjellige endringer per element; angi en oppdragsgiver eller forfallsdato på hvert element; gi nytt navn, endre rekkefølge, flytte og slette.
Neste prioriteringer	Oppdag lesbare personlige og teamkameratkøer, les nøyaktig rangeringsrekkefølge, og legg til, flytt eller fjern tildelte aktive kort når legitimasjons- og arbeidsområdeautoriteten tillater det
Agent kjører	Annonser arbeid under flyvningen på et kort med runs.start, rapporterer fremgang og hjerterytme med runs.update, lukke kjøringen med en terminalstatus, og sjekk hva som allerede kjører med runs.list
Arbeid og rapportering	Spørring avgrenset personlige eller synlige teamkort med forfalte, ikke-tildelte, inaktivitets- og sist-flyttede filtre; les hele den tilkoblede brukerens dag i en samtale med work.my_day; inspisere tidslinje tidsplaner og cross-board rollups med work.portfolio_summary; og generere personlige standup bevis på tvers av tilgjengelige boards
Aktivitet og fullført arbeid	Sidebrettaktivitet og korthistorikk, og les ferdigstillingshistorikk og ferdige poster
Notater	Sidenotat metadata, lese hele innholdet, opprette, oppdatere, koble, legge ved små filer, kopiere og endre rekkefølgen på personlige eller team notater
Kladd	Fange "minne meg til..." elementer til din private Kladd Innboks uten å velge en tavle, liste og lese sider, og kryss av elementer. Trenger en nettleser pålogging eller personlig nøkkel

Se på generert MCP verktøy inventar for hvert registrerte verktøynavn.

Kortforhold

cards.get Inkluderer kortets relations og hiddenBlockerCount. cards.set_relations legger til eller fjerner relasjoner i samme arbeidsområde:

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

direction er blocks, blocked_by, eller relates_toLes fra cardIdsiden. otherCardIds aksepterer ett kort referanse eller opp til 50; remove standard til false. Legger er idempotent og forplikte per mål. En delvis suksess returnerer failed Innlegg og alle notAttemptedCardIds ved siden av de resulterende forhold. Hvis den endelige lesingen mislykkes, addedCardIds og relationsUnavailable rapportere hva som ble lagret. Anropsfeilene når hver forsøk på endring blir avslått. Fjerning forplikter seg også per mål: removedCardIds bevarer vellykkede fjerninger ved siden av noen failed, notAttemptedCardIds, eller relationsUnavailable Detaljer. notFoundCardIds Navn på forhold den ikke kan se eller finne; de er alene.

En skrive-kompatible legitimasjon trenger redigere tilgang til cardId og alle kort som blir blokkert, og lese tilgang til de andre kortene. Sykluser, selvkoblinger, kryssarbeidsplasskoblinger og fullførte kort som nye blokkeringer blir avvist. Leser utelate utilgjengelige kortdetaljer, men teller skjulte aktive blokkeringer. Bruk filters: { blockedOnly: true } med work.query_cards for blokkerte åpne kort, eller atRiskOnly: true for åpne kort hvis synlige blokkering er forsinket eller forfaller etter dem; work.portfolio_summary begge deler; abonnerer på card.blocked og card.unblocked for overganger. Disse hendelsene fungerer uavhengig av konfigurerte automatiseringer.

Å fullføre gjennom MCP viser ikke en interaktiv blokkert arbeidsadvarsel. Les relasjonene først når du bestemmer om arbeidet er klart. En blokkert agent kjører (runs.update med status: "blocked") beskriver at kjøre og ikke skaper et kort avhengighet. Se Kortrelasjoner og blokkering.

Avhengighetsgrafer

cards.dependency_graph Svarer på hva som blokkerer et kort, hva det holder opp, og hvilket arbeid som er koblet over en tavle eller arbeidsområde. cardId (nøkkel, UUID eller kanonisk URL), boardId, eller workspaceId:

{ "cardId": "MKT-42" }

Verktøyet returnerer utvidet cards, edges, og truncated. Kortene inkluderer nøkkel, tittel, URL, kildetavle / listenavn, inScope, og tilgjengelige datoer, etiketter og tildelingsobjekter. openBlockerCount inkluderer aktive blokkeringer som den som ringer ikke kan se; offMapBlockerCount teller aktive blokkeringer som ikke er på dette kartet. Bare tilstedeværende, valgfrie verdier uten null er inkludert. A blocks edge løper fra sourceCardId til targetCardId.

Et kortomfang returnerer også focus: blockedBy og blocks er direkte forbindelser; upstream og downstream er transitive kort-ID-er i nærmeste første orden; relatedTo lister kontekstuelle lenker. onMap: false betyr at det forespurte kortet ble fullført, arkivert, ikke relatert eller på annen måte fraværende fra grafen. Fravær er ikke bevis på at et kort ikke har noen relasjoner.

Grafen følger blokkeringskoblinger begge veier gjennom lesbare åpne kort. Fullførte forutsetninger kan vises, men krysset fortsetter ikke gjennom dem. Skjulte kort telles uten å bli navngitt eller brukt til å bygge bro til annet arbeid. Relaterte naboer er inkludert ett hopp fra omfangets åpne frø. Responsen stopper ved 400 kort og sett truncated; smalere omfanget for mer detaljer. Dette er et leseverktøy. Bruk cards.set_relations Redigere lenker og avhengighet hendelser for å overvåke endringer.

Datoer

Datoinnganger godta YYYY-MM-DD eller hverdagslige setninger, løst i din egen tidssone fra din Kanera-profil: today, tomorrow 1pm, friday (Fridag, inkludert i dag) next friday (En uke etter det) in 2 weeks, next month, end of week, end of month, eller oct 12. session.get returnerer timeZone og today Kanera forfallsdatoer bruke tidsluker i stedet for nøyaktige tider, så en tid plukker den matchende sporet: opp til 09:00 er Morgen, opp til 13:00 Ettermiddag, opp til 17:00 Slutten av arbeidsdagenEn frase Kanera ikke kan lese er avvist med de aksepterte skjemaene i stedet gjettet.

Resultatrekkefølge

Hvert listeverktøys beskrivelse angir rekkefølgen resultatene kommer tilbake i, for eksempel "nyeste først" for kommentarer og aktivitet, visningsrekkefølge for lister og sjekklister, og snarest forfaller først for work.query_cards som standard.

Tidslinjeplaner og startdatoer

Bruk work.schedule Med nøyaktig en boardId eller workspaceId. Den leser den samme arbeidsdagen motoren som Tidslinjevisning, følger tilgjengelige tilkoblede kjeder på tvers av tavle, og utelukker fullførte og utilgjengelige kort. Visningsfiltre endrer ikke beregningen.

Resultat	Betydning
cards[].plannedStart, plannedEnd, durationDays	Det planlagte datointervallet og dets inkluderende mandag-fredag varighet.
earliestStart, earliestFinish, latestStart, latestFinish	Avhengighet-begrenset datoer og de siste datoene som bevarer kjedens finish.
slackDays, critical	Plass til å gli i arbeidsdager, og om tilkoblet arbeid ikke har slakk. Null slakk betyr at beregningen ikke har noe datoanker.
conflicts[]	Motstridende åpne blokkeringer, med blockerId, edgeId, kindog arbeidsdag days.
criticalEdgeIds	Forhold på den kritiske ruten.
summary	Planlagt/uplanlagt, konflikt og kritiske teller, datointervall, projectedFinish, latestDueog arbeidsdag slipDays mot siste frist.

Pass startDateLocalDate til cards.create, cards.update Innen changeseller hver innførsel av cards.bulk_create. Bruk YYYY-MM-DD eller en støttet relativ datofrase løst i brukerens sone; null tømme en eksisterende start. En start har ingen tidsluke og kan ikke være etter forfall. Disse skriver krever redigeringstilgang og flytter ikke automatisk etterfølgende datoer.

Det er ingen hypotetisk tidsplaninngang: foreslå en endring fra gjeldende tidsplan, og bruk den deretter og les den bare når en lagret endring er ment. Arbeidsplanlegging eksempler og planlegge hendelse nyttelaster. Funksjoner for planlegging av funksjonshemmede tilbake TIMELINE_DISABLED eller DEPENDENCIES_DISABLED for operasjoner som krever det.

Abonnement på arrangementer

En klient på gjeldende MCP-protokoll kan abonnere på card.created, card.updated, card.moved, og comment.created i et arbeidsområde, tavle eller kort, for å priorities.changed for den tilkoblede brukerens egen Up next-kø, og til my_day.ready for en ukedag morgen briefing ping, og motta hver forekomst på en verifisert HTTPS tilbakeringing det kontrollerer. Abonnementer tilhører tilkoblingen, varer opptil 24 timer per oppdatering, og sjekkes på nytt mot identitetens nåværende tilgang før hver levering. Se Abonner på arrangementer for katalogen, verifisering, signering, retries og feilkoder.

Innebygde prompter

Spør	Bruk
summarize_board_status	Undersøk ett tavle og oppsummer fremgang, blokkeringer, foreldet arbeid og neste handlinger.
prepare_standup_update	Kombiner personlig nåværende arbeid og paginert arbeidshistorie på tvers av tilgjengelige tavle for å lage et utkast til en standup.
draft_card_from_notes	Les et notat og lag en korttittel og en beskrivelse av Markdown uten å opprette kortet.

Normal samtale ber om arbeid selv når en AI-klient ikke utsetter MCP-spørremaler.

Sikkerhet og destruktive operasjoner

• Interaktiv og enhetskode OAuth alltid gi kanera:read og kanera:write; offline_access MCP-klienten kontrollerer verktøytilgjengelighet og godkjenninger, og Kanera håndhever brettroller. Administrasjonsverktøy fungerer bare der brukeren har den tilsvarende administratorrollen: organisasjonsadministratorer kan opprette arbeidsområder og frittstående tavler, og arbeidsområdeadministratorer kan legge til tavle og administrere automatiseringer.
• Hver OAuth-strøm binder autorisasjons-, kode-, oppdaterings- og tilgangstokenet til det kanoniske MCP resource.
• Rå kanera_mcp_... tilgangstokens aksepteres bare av MCP-endepunktet og avvises av /api/v1; MCP-tjenesten bruker en egen intern delegeringslegitimasjon med liten levetid for offentlige API-anrop.
• En enhetsautorisasjon bruker de samme omfang og de samme grensene. En enhetskode utløper etter ti minutter, kan byttes en gang, og godkjennes bare av en pålogget bruker som bekrefter koden som vises av klienten.
• Uovervåkede agenter og arbeidsområdenøkler er avkortet på deres konfigurerte omfang.
• Personlige nøkler arver eierens nåværende tillatelser og bør beskyttes som brukerens konto.
• Lest-scoped API-nøkler og uovervåket service legitimasjon kan ikke kalle beskyttede mutasjoner.
• API-nøkkel og MCP-aktivitet registreres med sin fungerende bruker- eller integrasjonsidentitet. En interaktiv OAuth-agent registreres som agenten som handler for brukeren: kommentarer og aktivitetsrader bærer agentens navn og gjengir som via <agent>, og brukeren blir varslet om hva agenten deres gjorde i stedet for å ha det undertrykt som sin egen handling. En personlig API-nøkkel som brukes av et skript, fungerer fortsatt som eier.
• Når du kobler fra OAuth eller sletter en uovervåket agent, tilbakekalles den aktive legitimasjonen.
• Bruk en egen legitimasjon per klient slik at en tilkobling kan tilbakekalles uten å påvirke en annen.

Kanera MCP kan ikke slette:

• Tavler
• Lister
• Etiketter eller egendefinerte felt
• Notater
• Merk vedlegg

Slett disse manuelt i Kanera. MCP kan arkivere eller fjerne arkiveringskort og kan arkivere de aktive kortene i en liste.

Administrasjon over MCP er begrenset til å opprette arbeidsområder og frittstående tavler (organisasjonsadministratorer, ved hjelp av et interaktivt OAuth-stipend eller en skrivekompatible personlig nøkkel), legge til tavler i et arbeidsområde og opprette, redigere, aktivere og slette automatiseringer (arbeidsområdeadministratorer). MCP kan ikke redigere, endre rekkefølge eller slette arbeidsområder, tavler, lister, etiketter, felt, alternativer, medlemmer eller oppbevaringsinnstillinger. Disse operasjonene forblir i Kanera-grensesnittet.

MCP kan slette permanent:

• En kommentar skrevet av den fungerende brukeren
• En sjekkliste og dens elementer
• En sjekkliste element

Disse verktøyskjemaene er merket destruktive. Bruk dem bare etter en eksplisitt forespørsel og verifiser målet før du ringer dem.

Feilsøking

Problem	Hva du skal sjekke
Kunden kan ikke koble	Bruk den nøyaktige /mcp URL for den Kanera du kobler til, som vist under Profilinnstillinger -> API-nøkler.
Klienten ber om et token i stedet for å åpne Kanera	Den støtter ikke ekstern MCP OAuth. Bruk en API-nøkkel eller en støttet klient.
Klienten har ingen nettleser å omdirigere til	Bruk enhetsautorisasjon hvis klienten støtter det, eller en API-nøkkel hvis den ikke gjør det.
Polling kommer tilbake slow_down	Poll ikke raskere enn interval tilbake med enhetskoden, og adopter det lengre intervallet etter hver slow_down.
Enhetssiden rapporterer en ugyldig eller utløpt kode	Kodene varer i ti minutter og fungerer en gang. Sjekk koden, logg inn først, og be om en ny kode fra klienten.
Token- endepunktet returnerer invalid_target	Send den eksakte MCP-adressen fra Profilinnstillinger -> API-nøkler som resource under autorisasjon og hver token utveksling.
API-nøkkelen er meldt savnet	Sett KANERA_API_KEY for stdio eller send Authorization: Bearer ... over HTTP.
En forespørsel returnerer 401	Påloggingsinformasjonen mangler, er feil, utløpt, tilbakekalt eller kopiert feil. Start OAuth på nytt eller erstatt API-nøkkelen.
En forespørsel returnerer 403	For personlig OAuth, bekreft at den fungerende brukeren er en redaktør i stedet for en observatør på målkortet. For en API-nøkkel eller uovervåket agent, bekreft også at legitimasjonen er skrivedyktig.
Agenten kan lese, men ikke redigere	Tillat skrivehandlingen i MCP-klienten og bekreft at den fungerende identiteten har tilgang til tavleredigering. For tjenestetilkoblinger og API-nøkler, bruk også en skrivekompatible legitimasjon. Eksisterende personlige OAuth-tilkoblinger trenger ikke å koble til igjen.
Agenten finner ikke en tavle	Bruk fullstendig board discovery. Et board kan være frittstående eller kun tilgjengelig gjennom eksplisitt gjestemedlemskap.
Agenten kan ikke administrere et arbeidsområde	MCP dekker bare opprettelse av arbeidsområder og tavler og administrasjon av automatiseringer, og bare der den fungerende identiteten er en administrator. Arbeidsområdeomfattet og skrivebeskyttet legitimasjon kan ikke opprette arbeidsområder. For annen administrasjon, bruk Kanera-grensesnittet eller et støttet offentlig REST-endepunkt.
En kodeagent har verktøy, men bruker dem dårlig	Installer den offisielle Kanera Agent Ferdighet.
Nye eller endrede verktøy vises ikke	Oppdater eller skann MCP- tjeneren i klienten på nytt slik at den henter gjeldende skjemaer. Start klienten på nytt hvis den ikke har noen oppdateringshandling. OAuth- autorisering kreves normalt ikke.
Kunden kan ikke abonnere på hendelser	Hendelsene trenger vertskap /mcp endepunkt og en klient på gjeldende MCP-protokoll; en standard kanera mcp server tilbyr dem aldri. Se Abonner på arrangementer for tilbakeringing og omfangsfeil.

Relaterte sider

• Kanera CLI

• Koble Kanera til din AI-agent

• Koble til OAuth eller en uovervåket agent

• Eksempler på hvordan du bruker Kanera med AI

• Abonner på arrangementer

• MCP verktøy inventar

• Offentlig API