Connecta el teu assistent d'IA

Connecta Wise Owl a Claude, ChatGPT o el teu agent de codi i demana-li les coses com les diries: «què em queda obert aquesta setmana?», «afegeix per a demà els seguiments d'aquesta PR», «planifica'm el dia». Llegeix els teus dies a tots els taulers, afegeix tasques, les marca com a fetes i les mou, amb les mateixes regles que l'app.

El servidor MCP de Wise Owl és en aquesta adreça (Streamable HTTP). És tot el que necessiten Claude i ChatGPT:

https://api.wiseowl.cat/mcp

Necessites un compte de Wise Owl: l'assistent treballa amb la llista que el compte manté sincronitzada. Sense compte, la teva llista no surt del navegador. Inclòs amb un compte gratuït. Registra't

Què pot fer un assistent

Aquestes són les eines del servidor. Segueixen les mateixes regles que l'app: les tasques pendents passen a avui, i cada tauler té els seus dies. Les eines de lectura miren tots els taulers, tret que l'assistent n'esmenti un.

Lectura

  • list_boards: els teus taulers, i quantes tasques hi ha obertes avui a cadascun.
  • get_day: les tasques d'un dia, amb el seu estat i quantes vegades s'ha passat cadascuna. En obrir avui, primer hi porta el que ha quedat pendent, com fa l'app. A Claude, el dia surt com una llista que pots marcar al mateix xat.
  • list_days: les tasques d'un interval de dies, fins a 31.
  • search_tasks: cerca tasques pel text i, si vols, per estat o entre dues dates.
  • get_stale_tasks: les tasques obertes que es van passant una vegada i una altra: candidates a fer ara, dividir o descartar.
  • get_summary: quantes tasques s'han fet, passat, descartat o deixat obertes en un període de fins a 92 dies, en total i per dia.

Escriptura

  • add_tasks: afegeix fins a 50 tasques de cop, per a avui o un dia posterior, al tauler que diguis.
  • set_status: marca una tasca com a feta, oberta de nou, «no es farà» o per a l'endemà.
  • edit_task: reescriu el text d'una tasca.
  • move_task: planifica una tasca oberta per a un altre dia, com quan la passes a l'app.
  • delete_task: esborra una tasca de tots els dies on és. Està marcada com a destructiva, així que un assistent ben educat t'ho pregunta abans.

Prompts

  • plan_my_day: mira avui i les tasques que es van passant, i proposa un pla sense canviar res fins que tu ho diguis.
  • weekly_review: repassa els últims set dies: què has fet, què s'ha anat passant i què canviar. No toca cap tasca.

Configura-ho

Claude i ChatGPT inicien sessió amb OAuth: només necessiten l'adreça, i tu entres a Wise Owl i hi dones permís, sense claus per copiar. Per a Claude Code, Cursor, VS Code, Windsurf i altres clients, crea un token d'accés a Wise Owl i afegeix-lo amb la mateixa adreça.

Claude (web i escriptori)

  1. A Claude, obre Configuració → Connectors i afegeix un connector personalitzat.
  2. Enganxa-hi l'adreça de Wise Owl: https://api.wiseowl.cat/mcp
  3. Inicia sessió a Wise Owl i dona-hi permís. Sense claus per copiar: és OAuth.

A l'app d'escriptori de Claude, els passos són els mateixos.

ChatGPT

ChatGPT s'hi connecta amb la mateixa adreça: afegeix-hi un connector personalitzat amb aquesta adreça, inicia sessió a Wise Owl i dona-hi permís.

Crea un token d'accés

Claude Code, Cursor, VS Code i Windsurf es connecten amb un token:

  1. Entra a Wise Owl i obre Configuració de l'usuari → Assistents connectats.
  2. Escriu el nom de l'assistent i fes clic a Crea un token.
  3. Copia el token, que comença per wo_pat_, de seguida: no es tornarà a mostrar. Pot llegir i canviar les teves tasques, i caduca al cap de 90 dies.

Claude Code

Executa això en un terminal, amb el teu token en lloc de wo_pat_…. Quan crees un token, Wise Owl et mostra aquesta ordre amb el token ja posat.

claude mcp add --transport http wiseowl https://api.wiseowl.cat/mcp --header "Authorization: Bearer wo_pat_…"

Cursor

Afegeix Wise Owl a ~/.cursor/mcp.json per a tots els projectes, o a .cursor/mcp.json en un sol projecte, amb el teu token:

{
  "mcpServers": {
    "wiseowl": {
      "url": "https://api.wiseowl.cat/mcp",
      "headers": { "Authorization": "Bearer wo_pat_…" }
    }
  }
}

VS Code

Afegeix Wise Owl a .vscode/mcp.json del projecte, o a la configuració d'usuari (MCP: Open User Configuration a la paleta d'ordres). VS Code et demana el token el primer cop que arrenca el servidor, i així no queda al fitxer:

{
  "inputs": [
    {
      "type": "promptString",
      "id": "wiseowl-token",
      "description": "Wise Owl access token",
      "password": true
    }
  ],
  "servers": {
    "wiseowl": {
      "type": "http",
      "url": "https://api.wiseowl.cat/mcp",
      "headers": { "Authorization": "Bearer ${input:wiseowl-token}" }
    }
  }
}

Windsurf

Windsurf, que ara es diu Devin Desktop, llegeix els servidors MCP de mcp_config.json. Afegeix-hi Wise Owl amb el teu token:

{
  "mcpServers": {
    "wiseowl": {
      "serverUrl": "https://api.wiseowl.cat/mcp",
      "headers": { "Authorization": "Bearer wo_pat_…" }
    }
  }
}

Altres clients MCP

Qualsevol client compatible amb Streamable HTTP s'hi pot connectar: dona-li l'adreça i, si no pot iniciar sessió amb OAuth, la capçalera Authorization: Bearer wo_pat_… amb el teu token.

Permisos

Hi ha dos permisos, o àmbits (scopes):

  • tasks:read: llegir les teves tasques i dies.
  • tasks:write: afegir, canviar, moure i esborrar les teves tasques.

Quan connectes un assistent amb OAuth, Wise Owl et mostra què demana, i tu li dones permís o no. Un token d'accés té tots dos permisos.

Els assistents poden llegir i canviar tasques i res més: ni la contrasenya, ni el compte, ni la facturació. Els tokens caduquen, i en pots revocar un o desconnectar un assistent quan vulguis.

La configuració mostra què ha afegit, reescrit, mogut o esborrat cada assistent, i cada canvi es pot desfer. Esborrar està marcat com a destructiu, així que un agent ben educat t'ho pregunta abans.

Un assistent veu el text de les tasques que llegeix: connecta només els que et mereixin confiança.

Revoca l'accés

A Wise Owl, obre Configuració de l'usuari → Assistents connectats. Fes clic a Desconnecta al costat d'un assistent que hagis connectat amb OAuth, o a Revoca al costat d'un token d'accés. Deixa de funcionar a l'instant, i un assistent que desconnectis t'ha de tornar a demanar permís. Si esborres el compte, es revoquen tots.

Treure Wise Owl de la configuració de l'assistent no li revoca l'accés: fes-ho també a Wise Owl.