Integra airfocus con gli strumenti IA utilizzando il server MCP airfocus

Configura il server MCP airfocus

Il server MCP airfocus è compatibile con qualsiasi client MCP, inclusi quelli elencati di seguito. Sebbene il processo di configurazione vari a seconda del client utilizzato, l'URL del server necessario per configurare l'airfocus MCP è lo stesso:

• https://mcp.airfocus.app/mcp
  • Questo URL non è destinato a essere visitato nel tuo browser. È un parametro che userai per collegare lo strumento IA al server MCP di airfocus.

I passaggi per collegarsi al server MCP di airfocuspossono variare tra gli strumenti IA. Consulta la documentazione fornita dai seguenti strumenti IA compatibili linkati di seguito:

• ChatGPT
• Claude desktop
• Claude web
• Microsoft Copilot Studio
• GitHub Copilot
• Cursor
• Codice Claude
• Windsurf

Questa non è una lista esaustiva di client supportati: il server MCP airfocus può connettersi a qualsiasi client MCP.

Lavoriamo duramente per garantire che le informazioni nel centro di assistenza siano aggiornate. Tuttavia, le risorse di terze parti collegate in questa sezione non sono di proprietà di airfocus e possono cambiare senza preavviso. Se noti che queste informazioni sono obsolete, ti preghiamo di farcelo sapere qui.

Requisiti di configurazione JSON

Alcuni strumenti di IA potrebbero richiedere di modificare manualmente un file di configurazione JSON per collegarli a un server MCP.

Se il tuo strumento IA supporta il metodo di trasporto HTTP, usa questa configurazione JSON:

"airfocus": {
"type": "http",
"url": "https://mcp.airfocus.app/mcp"
}

Se il tuo strumento IA non supporta il metodo di trasporto HTTP, devi eseguire un server locale per inoltrare le richieste HTTP al server MCP di airfocus. Questo può essere realizzato utilizzando il pacchetto Node.js mcp-remote. Assicurati di averlo installato Node.js sul tuo computer, poi usa la seguente configurazione JSON:

"airfocus": {
"command": "npx",
"args": ["-y", "mcp-remote", "https://mcp.airfocus.app/mcp"]
}

Azioni disponibili con il server MCP airfocus

Una volta configurato il server MCP airfocus , puoi usarlo per completare varie azioni in airfocus inserendo un prompt nel tuo strumento IA. Man mano che aggiungiamo più casi d'uso al server MCP airfocus , potresti dover riautenticarti con il tuo strumento IA affinché la nuova funzionalità funzioni.

Attualmente sono supportati i seguenti casi d'uso:

• Cerca airfocus articoli per contenuti specifici.
  • Esempio: "Mostrami tutti gli elementi in airfocus relativi al redesign dell'onboarding."
• Recupera e riassume i dettagli e i contenuti degli oggetti.
  • Esempio: "Trova gli elementi 'Q3 Roadmap Review' su airfocus e fammi un riassunto di ciò che è in corso."
• Filtra e sfoglia gli elementi per spazio di lavoro, stato, assegnato o altri campi.
  • Esempio: "Mostrami tutti gli elementi assegnati-mi che sono attualmente in stato 'In corso' nel mio spazio di lavoro Iniziative."
• Ricevi approfondimenti sui clienti collegati a prodotti specifici.
  • Esempio: "Quale feedback dei clienti è collegato all'opportunità 'Required Fields' in airfocus?"
• Crea nuovi elementi in uno spazio di lavoro con un titolo, una descrizione e campi opzionali.
  • Esempio: "Crea un nuovo elemento nel mio workspace Roadmap chiamato 'Migliorare il flusso di onboarding' e imposta lo stato su 'Candidato'."
• Aggiungi commenti agli elementi di airfocus esistenti.
  • Esempio: "Aggiungi un commento all'elemento 'Campi Richiesti' che dica 'Stiamo pianificando di definire questo ambito nel prossimo trimestre — aggiorneremo una volta che avremo una stima.' "
• Crea Insight dal feedback dei clienti.
  • Esempio: "Crea un Insight dall'elemento di feedback 'SSO blocca adozione' e collegalo all'opportunità 'SSO Support'."
• Aggiorna gli elementi esistenti in uno spazio di lavoro.
  • Esempio: "Assegna questo elemento a John e aggiorna lo stato a "Attivo". Imposta il campo dei quarti al quarto trimestre 2027."

Per gli amministratori: abilita o disabilita l'uso del server MCP per il tuo Team

Gli amministratori degli account Aziendale possono decidere se concedere o meno agli utenti del loro Team l'accesso al server MCP airfocus .

Per limitare o consentire l'accesso al server MCP airfocus per il tuo team:

1. Clicca sul tuo nome nell'angolo in basso a sinistra di airfocus.
2. Seleziona Team impostazioni.
3. Seleziona la scheda Caratteristiche in alto nel pannello.
4. Sotto "airfocus MCP", usa il toggle accanto a "Abilita airfocus MCP".
5. Clicca su Abilita l'accesso MCP o Disabilita l'accesso MCP nel modale che appare.

FAQ

Come funziona il server MCP airfocus ?
Il server MCP airfocus è un servizio remoto disponibile su https://mcp.airfocus.app/MCP. Utilizza il protocollo di trasporto HTTP streamable e la Dynamic Client Registration (DCR) per gestire in modo sicuro l'accesso dei client. L'autenticazione viene gestita tramite OAuth 2.0, consentendo agli utenti airfocus autorizzare il server MCP a integrarsi con i loro strumenti IA. Durante la configurazione, gli utenti completano due distinti passaggi di autorizzazione:

• Autenticazione dei server: Verifica e registra il server MCP airfocus come servizio affidabile.
• Approvazione dell'ambito del permesso: Concede al server MCP l'accesso ai tuoi oggetti, spazi di lavoro e Insight all'interno di airfocus.

Sono necessarie sia l'autenticazione che l'approvazione dello scope prima che il server MCP airfocus possa interagire con i dati del tuo team.

A quali informazioni può accedere il server MCP airfocus ?
Il server MCP airfocus può accedere a qualsiasi elemento, spazio di lavoro e Insight hai permessi all'interno del tuo team airfocus , inclusi titoli degli oggetti, descrizioni, valori dei campi, stati e Insightcollegati. Non può accedere ai dati appartenenti ad altri airfocus Team.

Come vengono utilizzati i miei dati dal server MCP airfocus ?
Il server MCP airfocus agisce come un pass-through e non conserva contenuti degli elementi, prompt degli utenti o query. Le tue credenziali non vengono mai condivise al di fuori del tuo airfocus Team. L'uso del server MCP di airfocus è soggetto ai Termini di Servizio standard di airfocus.

Come interagisce il airfocus MCP con i dati sincronizzati con integrazioni come Jira o Azure DevOps?
Le modifiche apportate agli elementi all'interno di airfocus possono sincronizzarsi con un'integrazione di terze parti a seconda della configurazione dell'integrazione all'interno dello spazio di lavoro. Se una modifica effettuata direttamente da un utente all'interno di airfocus si sincronizzasse automaticamente con una terza parte, lo stesso comportamento di sincronizzazione si verificherà con le modifiche effettuate dagli utenti tramite il server MCP. Consigliamo di rivedere la configurazione di integrazione all'interno di airfocus prima di abilitare il server MCP.

Risorse

Per saperne di più su questa funzione, esplora le risorse aggiuntive qui sotto. Queste risorse sono disponibili solo in inglese.

Risorse esterne
Per saperne di più sui server MCP, consulta questa documentazione esterna:

• Cos'è il Model Context Protocol (MCP)?

Dai un feedback su questo articolo