Nxtly MCP

Bruk Nxtly fra MCP-klienter som Claude, ChatGPT, Claude Code, Cursor og VS Code. Assistenten kan lese dagsoversikten, finne, opprette, endre og fullføre oppgaver, og lese eller skrive notater.

Det finnes to servere:

Ekstern server

Serveren bruker Streamable HTTP med tilstandsløse JSON-svar og støtter protokollversjonene 2024-11-05 til 2025-11-25. Hvert verktøy kjører det tilsvarende REST-kallet med brukerens egen autentisering. Roller, synlighet og API-rettigheter er dermed de samme som på nett og i Apple-appen.

Koble til en assistent

Klienter med OAuth: legg til https://api.nxtly.app/v1/mcp som egendefinert MCP-tilkobling. Klienten registrerer seg og åpner Nxtlys godkjenningsside. Logg inn med Nxtly-passordet ditt og godkjenn tilgangen. Kontoer med aktivert tofaktorautentisering kan ikke kobles til ennå. Passordendring kobler fra alle klienter. På nettsiden kan du se og fjerne tilkoblinger under Konto → MCP-tilkoblinger. API-et tilbyr GET /v1/me/connections og DELETE /v1/me/connections/{uuid}.

Claude Code:

claude mcp add --transport http nxtly https://api.nxtly.app/v1/mcp

Klienter med fast autentiseringsheader: opprett en API-nøkkel for arbeidsområdet og send den som Bearer-token. Nøkkelen gir tilgang til ett arbeidsområde, uten notater. Se API-referansen.

{
  "mcpServers": {
    "nxtly": {
      "type": "http",
      "url": "https://api.nxtly.app/v1/mcp",
      "headers": { "Authorization": "Bearer nxtly_..." }
    }
  }
}

Forespørsler fra nettleser må komme fra et opphav i MCP_ALLOWED_ORIGINS (standard: CORS_ALLOWED_ORIGINS). Klienter som kjører på server, sender normalt ikke Origin-header.

Verktøy

Tagger er personlige. Bare du ser dem, også på delte oppgaver. Send navn som bug eller feature; en innledende # ignoreres. Den lokale stdio-serveren har de samme taggverktøyene, og create_task og update_task tar tags, add_tags og remove_tags.

Tidspunkter returneres i brukerens tidssone. Dato og klokkeslett uten angitt UTC-forskyvning tolkes i denne tidssonen. En dato uten klokkeslett betyr kl. 09:00.

Lokal testing

make serve-api
NXTLY_TEST_BASE_URL=http://127.0.0.1:8501/v1 node api/tests/mcp-oauth.cjs

Testen oppretter nye testkontoer i en isolert database der migreringene er kjørt. Den kontrollerer verktøy, nøkkelrettigheter og hele OAuth-flyten: registrering, godkjenning, PKCE, tokenrotasjon, oppdagelse av gjenbruk og frakobling.

Lokal stdio-server

stdio-serveren gir MCP-klienter tilgang til prosjekter, prosjektmedlemmer og delte oppgaver. Den bruker samme REST API og tilgangskontroll som nett- og Apple-klientene.

Installer låste avhengigheter én gang fra repoets rot med npm ci.

Autentisering

Bruk en nøkkel bundet til arbeidsområdet for en varig integrasjon:

export NXTLY_API_KEY=nxtly_...
export NXTLY_PROJECT_ID=prosjektets-uuid
npm run mcp

Opprett nøkkelen under Innstillinger → Integrasjoner → API-nøkler i den oppdaterte Apple-appen, eller Konto → Integrasjoner og API-nøkler på nett. Du kan også bruke POST /v1/api-keys med brukertoken, X-Workspace for arbeidsområdet og disse rettighetene:

{
  "name": "Min MCP-klient",
  "scopes": ["tasks:read", "tasks:write", "tasks:update", "tasks:complete", "projects:read", "members:manage"]
}

Hele nøkkelen returneres bare én gang. Brukertoken støttes også gjennom NXTLY_ACCESS_TOKEN. NXTLY_REFRESH_TOKEN aktiverer tokenrotasjon i prosessen.

Ved lokal utvikling kan du sette NXTLY_API_URL=http://127.0.0.1:8501/v1. Eksterne API-adresser må bruke HTTPS.

Klientoppsett

{
  "mcpServers": {
    "nxtly": {
      "command": "node",
      "args": ["/absolutt/sti/til/nxtly/mcp/server.mjs"],
      "env": {
        "NXTLY_API_KEY": "nxtly_...",
        "NXTLY_PROJECT_ID": "prosjektets-uuid"
      }
    }
  }
}

De 20 verktøyene dekker oppretting, lesing, endring og sletting av prosjekter; medlemmer; invitasjoner; samt søk, oppretting, endring, fullføring, sletting og gjenoppretting av oppgaver. Kjør npm run test:mcp for en protokolltest som ikke kontakter REST API-et.

Utvidet notatstøtte

HTTP-serveren tilbyr nå også update_note, delete_note og restore_note. update_note kan endre title, markdown og pinned; Markdown erstatter hele innholdet, så les notatet først. get_note returnerer både text og markdown. append_to_note bruker det atomiske REST-endepunktet og bevarer samtidige tilføyelser. Tilføyelse er ikke idempotent; ved uklart nettutfall må klienten lese notatet før et eventuelt nytt forsøk.

Den lokale stdio-serveren tilbyr list_notes, search_notes, get_note, create_note, update_note, append_to_note, delete_note og restore_note med NXTLY_ACCESS_TOKEN. Med NXTLY_API_KEY tilbys lesing, oppretting og endring etter nøkkelens rettigheter; sletting og gjenoppretting krever notes:delete. create_note tar markdown; søk returnerer workspace-referanser. Lesing, redigering, sletting og tilføyelse finner prosjektet automatisk når project_id ikke er oppgitt. Ved gjenoppretting av et prosjektnotat må project_id oppgis, siden slettede notater ikke kan finnes gjennom søk. Et konfigurert NXTLY_PROJECT_ID brukes som standard workspace.

HTTP bruker create_note med text for bakoverkompatibilitet; innholdet er det samme Markdown-tekstfeltet. Verktøyene markerer lesing, destruktive endringer og ikke-idempotente tilføyelser i MCP-annotasjonene.

API-nøkler støtter notes:read for lesing og søk, notes:write for nye notater og notes:update for endring og tilføyelser i egne notater i nøkkelens arbeidsområde. Sletting og gjenoppretting krever notes:delete; deling krever innlogging i appen. Levetid kan være 30, 90, 180 eller 365 dager, eller Aldri.

Velg Alle arbeidsområder eller send workspace_scope: "all" ved oppretting for å følge alle nåværende og fremtidige medlemskap. Ekstern MCP kan liste og søke på tvers; i stdio velges arbeidsområde med project_id. Oppretting, endring, fullføring og sletting av oppgaver styres av henholdsvis tasks:write, tasks:update, tasks:complete og tasks:delete. Prosjektsletting krever projects:delete.