MCP di minddy

minddy MCP permette a un assistente esterno di leggere e modificare il lavoro entro i permessi del tuo account. Collega il client tramite OAuth, controlla gli accessi e usa gli schemi correnti degli strumenti prima di intervenire. Le connessioni MCP di Numo verso altri servizi sono una funzione distinta.

Collegare un assistente esterno a minddy MCP

Apri la pagina pubblica MCP dell’istanza e scegli le istruzioni del client. Usa l’endpoint mostrato, che termina con /api/mcp. In self-hosted usa la tua origine, non Cloud. Il client deve supportare MCP remoto e il flusso OAuth descritto.

Accedi nel browser e verifica l’autorizzazione prima di concederla. La connessione agisce come il tuo account minddy senza accedere a progetti esclusi dai tuoi permessi. Inizia leggendo un ticket già accessibile e controlla il progetto restituito.

Scegli il client per visualizzare il comando o la configurazione di installazione.

Disponibilità di MCP e accesso alla rete

MCP è incluso in minddy self-hosted e si avvia con l’applicazione. Funziona subito su /api/mcp, all’origine dell’istanza configurata con MINDDY_PUBLIC_APP_URL. Include il rilevamento OAuth e la registrazione dinamica dei client: non servono un server MCP separato, un’applicazione OAuth dedicata o un proxy di minddy Cloud. Collega il client MCP all’endpoint della tua istanza, accedi e concedi l’accesso tramite il consenso nel browser.

La disponibilità del servizio non ne garantisce la raggiungibilità in rete. Sia il client MCP sia il browser usato per l’autorizzazione devono poter raggiungere gli URL MCP e OAuth annunciati. Se imposti esplicitamente OAUTH_ISSUER, anche quell’origine deve essere raggiungibile. Il client deve supportare la connessione, il flusso OAuth e il percorso di rete scelto; alcuni client richiedono HTTPS anche nelle reti private.

• Stesso computer: http://localhost:6463/api/mcp funziona con un client compatibile eseguito sul computer che ospita l’istanza locale. localhost e 127.0.0.1 indicano il computer che avvia la connessione. Il lanciatore di istanze locali dell’app desktop ascolta solo sull’interfaccia di loopback; un altro computer o un agente ospitato nel cloud non può raggiungerlo direttamente. Aprire l’URL localhost del server su un altro computer rimanda a quell’altro computer.

• LAN o VPN: un’istanza configurata come http://192.168.1.50 annuncia http://192.168.1.50/api/mcp. Un client nella LAN, o collegato tramite VPN, può usarla se indirizzo di ascolto, origine configurata, porta dell’applicazione, firewall e instradamento consentono l’accesso. Il browser deve raggiungere gli stessi URL di autorizzazione annunciati. Serve un’installazione server raggiungibile; cambiare solo l’URL del client non espone un processo limitato al loopback.

• Fuori dalla rete privata: usa un’origine HTTPS raggiungibile, per esempio https://tickets.example.com/api/mcp, o un altro percorso di rete supportato dal client. Un agente ospitato deve avere un proprio percorso verso l’istanza; la VPN sul computer del browser da sola non gli fornisce quel percorso. Ospitare minddy localmente non lo espone automaticamente a Internet.

Ambito e revoca

I client esterni usano gli strumenti disponibili per ticket, piani, commenti, pagine, feedback, cicli, routine e taccuino entro i permessi autorizzati. Gli strumenti seguono, a ogni chiamata, il tuo ruolo attuale in ciascun progetto, quindi un cambio di ruolo si applica senza riconnettersi. Come lettore ottieni gli strumenti di lettura, più quelli dei commenti quando il proprietario ha attivato Può commentare per te. MCP è disponibile in tutti i piani Cloud; l’IA del client dipende comunque da configurazione e costi propri.

minddy MCP nelle impostazioni dell’account elenca accessi esterni e controlli di revoca. Revoca client inutilizzati o non più affidabili. Il riquadro MCP per Numo della scheda IA e Numo è distinto: collega Numo ad altri servizi. Non incollare token in ticket, feedback pubblici o screenshot.

Questo esempio si connette a minddy Cloud. Per un’istanza autogestita, usa l’origine della tua istanza; il comando mostrato non è stato eseguito per questa cattura.

Usare minddy MCP e scoprire gli strumenti attuali

/api/mcp usa Streamable HTTP, strumenti stateless e OAuth 2.1. Collega il tuo account tramite il consenso nel browser; le vecchie chiavi mdyk_ non sono accettate. Usa minddy_list_projects per trovare gli UUID, poi leggi gli schemi del server collegato. /llms-full.txt genera i parametri esatti dai registri degli strumenti. Non ricostruirli da un elenco obsoleto. Ogni strumento di progetto ricontrolla l’accesso e restituisce codici di errore stabili.

Leggere prima di modificare i piani

Per trovare una issue, chiama minddy_list_issues con query: la ricerca considera le parole del titolo e della descrizione, un identificatore o un numero. Le corrispondenze testuali e gli identificatori esatti vengono per primi; una ricerca descrittiva può poi aggiungere issue dello stesso progetto trovate per significato, contrassegnate con match: "semantic". Leggi una issue di questo tipo prima di agire. La ricerca per significato viene addebitata al tuo account come Ricerca dei ticket e non avviene se hai disattivato Indicizza i ticket.

minddy_get_issue accetta l’UUID di una issue, un identificatore di issue come DEMO-42 oppure il numero della issue; project_id viene fornito separatamente. plan_tasks indica task_index a partire da zero. minddy_update_plan_task riceve un array tasks con gli stati pending, in_progress, completed o cancelled; un indice non valido fa rifiutare l’intero batch. minddy_append_to_plan aggiunge contenuto, mentre minddy_edit_issue_text sostituisce una coppia old_string/new_string esatta e univoca. Rileggi un piano che può essere cambiato: sostituirlo interamente potrebbe sovrascrivere il progresso di altri. La sezione ## Questions è esclusa dal conteggio delle attività.

Le letture che restituiscono testo con immagini (minddy_get_issue, minddy_get_objective, minddy_get_page, minddy_get_feedback, minddy_get_scratchpad) le elencano in images, ognuna con il suo src e il testo alternativo. Passa quel src così com’è a minddy_get_image: lo strumento verifica il tuo accesso al progetto dell’immagine, o che un’immagine del taccuino sia tua, e restituisce l’immagine fino a 10 MB con un download_url firmato valido circa dieci minuti. Un’immagine ospitata fuori da minddy torna solo come URL.

Rispettare revisioni e proprietà

minddy_list_pages mostra la gerarchia, minddy_search_pages restituisce estratti e minddy_get_page restituisce Markdown, commenti e valori completi. Preferisci modifiche parziali e usa la versione corrente quando sostituisci il contenuto. Conserva esattamente gli URL di file e immagini. minddy_create_page con database=true crea un database di pagine. minddy_update_page_database richiede la revisione del database per le modifiche allo schema e il valore precedente per le modifiche alle celle.

Per convertire un tipo, usa operation=convert con propertyId, targetType, revision e preview=true. Controlla incompatibleCount, quindi invia le stesse impostazioni con preview=false e il token restituito. Imposta confirmLoss=true solo dopo che l’utente ha autorizzato esplicitamente la cancellazione dei valori incompatibili.

Gli strumenti delle routine, riservati al proprietario, creano, modificano, sospendono o eliminano routine attivate da una pianificazione, da un evento o da una nuova voce di database. Leggi prima di creare per evitare duplicati. minddy_add_resource limita i file a 10 MB; gli strumenti delle pagine non inventano URL.

Verificare con un esempio

L’esempio modifica la prima attività di un piano già letto. Sostituisci l’UUID del progetto e il ticket con quelli trovati tramite discovery, e usa l’indice dell’ultima lettura. Controlla poi plan_tasks e plan_progress. Per un errore di accesso, verifica account e progetto; per un conflitto, rileggi e applica solo la modifica necessaria. Non ripetere una modifica esterna con esito incerto senza averne verificato il risultato.

{
  "project_id": "00000000-0000-4000-8000-000000000001",
  "issue": "DEMO-42",
  "tasks": [{"task_index": 0, "state": "in_progress"}]
}

Scegliere un obiettivo per un feedback

Le letture dei feedback includono objective_id; minddy_list_feedback accetta un filtro facoltativo per obiettivo (null seleziona richieste senza obiettivo). Usa minddy_link_feedback_objective con project_id, feedback_post_id e objective_id solo su richiesta esplicita dell’utente; null rimuove il collegamento. L’obiettivo deve essere attivo e appartenere allo stesso progetto. Il dettaglio dell’obiettivo include linked_feedback. Il proprietario può fornire objective_id a minddy_create_integration per una chiave di feedback, oppure modificare l’impostazione con minddy_update_integration_objective. I feedback esistenti mantengono la scelta. La conversione eredita obiettivo e categorie; la revisione di Numo non assegna mai obiettivi.