Verbind je AI-assistent met Azumuta – Azumuta

BETA: Azumuta MCP is momenteel in bèta en kan nog veranderen. Het is alleen beschikbaar via opt-in. Om deel te nemen aan de bèta of vragen te stellen, neem contact op met support@azumuta.com.

Model Context Protocol (MCP) verbindt je favoriete AI-assistent met toegestane Azumuta-gegevens. Je kunt vragen stellen over werkinstructies, productorders, recordings en issues zonder die gegevens handmatig in een gesprek te kopiëren.

De Azumuta MCP-tools zijn alleen-lezen. Ze kunnen je workspace niet wijzigen. Zie Azumuta MCP gebruiken voor voorbeelden en beperkingen.

Voor je begint

Schakel de MCP-bèta in voor je workspace.
Gebruik een AI-assistent die door je organisatie is goedgekeurd. De assistent moet externe MCP-verbindingen en een Headernaam ondersteunen.
Zorg ervoor dat je toestemming hebt om API-apparaten te beheren, of vraag je workspace-beheerder om de sleutel aan te maken.
Controleer welke gegevens je mag delen met de AI-client en de modelprovider ervan. Opgehaalde gegevens gaan naar die client en provider.

Cursor is het geïllustreerde voorbeeld in deze guide. Andere AI-assistenten hebben verschillende instellingsbesturingselementen. Je hoeft de Azumuta MCP-server niet op je computer te installeren.

Als API scopes niet beschikbaar is, of voor hulp bij de verbindingsinstellingen, neem contact op met support@azumuta.com.

Maak een sleutel met leestoegang

Een API-sleutel selecteert de workspace en bepaalt welke gegevenscategorieën de assistent kan openen. De toegang ervan hoeft niet noodzakelijk overeen te komen met je web-app-machtigingen. Vraag je beheerder om dit te controleren voordat je verbinding maakt.

Maak een speciaal API-apparaat in de workspace die je wilt verbinden.
Open Device bewerken voor dat apparaat.
Open Veiligheid.
Onder API scopes, selecteer Beperk deze API key tot een deelverzameling van operaties.
Wis de geselecteerde scopes die je niet nodig hebt. De initiële selectie bevat alle scopes.
Selecteer alleen de vereiste Read-opties uit de tabel hieronder.
Sla het apparaat op.
Kopieer de API-sleutel ervan.

Scopegroep	Leestoegang	Scope-identifier
Werkinstructies	Werkinstructies, inhoud en versies	`workinstructions:read`
Recordings	Werkinstructie-recordings en gestructureerde rapportgegevens	`recordings:read`
Producten	Productorders en hun uitvoeringsdetails	`products:read`
Issues	Issues, borden, flows en statuswijzigingen	`issues:read`
Gebruikers	Gebruikersdetails	`users:read`
Spots	Zones en stations	`spots:read`

MCP vereist expliciete scopes. Een sleutel zonder geselecteerde scopes biedt geen onbeperkte MCP-toegang. Sommige vragen hebben meerdere scopes nodig, zoals Werkinstructies en Recordings.

API scopes gefilterd op Werkinstructies, met Lezen geselecteerd en Schrijven en Verwijderen gewist

Verbind je favoriete AI-assistent

Voor een workspace op app.azumuta.com, gebruik deze instellingen:

Instelling	Waarde
Verbindingstype	Remote MCP met Streamable HTTP
Server-URL	`https://mcp.azumuta.com/mcp`
Headernaam	`Authorization`
Headerwaarde	`Bearer <AZUMUTA_API_KEY>`

Vervang <AZUMUTA_API_KEY> door je sleutel. Behoud de spatie na Bearer. Deze verbinding gebruikt een API-sleutel, geen Azumuta-browseraanmelding.

Gebruik een sleutel uit de overeenkomende omgeving. Een sandbox-sleutel maakt geen verbinding met productie. Voor een ander milieu, gebruik het bevestigde MCP-eindpunt ervan.

Voorbeeld: verbinden in Cursor

Open Cursor-instellingen.
Open Aanpassen.
Selecteer MCPs.
Selecteer Nieuwe MCP-server. Cursor opent het configuratiebestand mcp.json op gebruikersniveau.
Voeg de azumuta-vermelding hieronder toe in mcpServers. Behoud eventuele bestaande serveringangen.
Vervang <AZUMUTA_API_KEY> door je speciale sleutel.
Sla het bestand op.
Ga terug naar Aanpassen → MCPs.
Open de Azumuta-serverinstellingen.
Als de verbinding is uitgeschakeld, schakel deze in.
Controleer of de verbinding Verbonden toont en de verwachte tools opsomt.

{
  "mcpServers": {
    "azumuta": {
      "url": "https://mcp.azumuta.com/mcp",
      "headers": {
        "Authorization": "Bearer <AZUMUTA_API_KEY>"
      }
    }
  }
}

Het bestand op gebruikersniveau is ~/.cursor/mcp.json. Het kan deze verbinding beschikbaar maken in je projecten. Plaats geen echte sleutel in een gedeelde projectconfiguratie, repository, prompt of screenshot. Cursor ondersteunt ook omgevingsvariabelereferenties in headerwaarden; zie Cursor's MCP-documentatie.

Cursor toont de Azumuta-verbinding als Verbonden en somt leestools op

Controleer de verbinding

In de geïllustreerde Cursor-versie staat de modus Agent deze MCP-aanroepen toe. De modus Vragen kan ze blokkeren. Beperk het verzoek tot Azumuta MCP en controleer de gebruikte tools. Andere Agent-tools kunnen schrijftoegang hebben.

Start een nieuw gesprek met je AI-assistent.
Voer in: Gebruik Azumuta MCP om vijf werkinstructies op te sommen. Voeg hun namen en ID's toe.
Als de client goedkeuring aanvraagt, controleer de tool en de argumenten ervan voordat je de lezing goedkeurt.
Vergelijk de geretourneerde werkinstructies met de geselecteerde Azumuta-workspace.

Deze controle vereist Werkinstructies: Lezen. Een lege lijst betekent niet automatisch dat de verbinding is mislukt. Controleer het toolantwoord en of de workspace toegankelijke werkinstructies bevat.

Doorgaan met voorbeeldvragen en beperkingen.

Verbindingsproblemen

Symptoom	Controleer
Verificatiefout	Bevestig het eindpunt, overeenkomend milieu, API-sleutel en `Bearer`-header. Voeg de sleutel nooit in een ondersteuningsbericht in.
Toegang geweigerd of geen verwachte tools	Bevestig bètaoegang en de expliciete Read-scopes van de sleutel. Na het wijzigen van scopes, maak opnieuw verbinding of vernieuw de toollijst.
Een record kan niet worden gevonden	Controleer de naam of ID ervan en de workspace die door de sleutel is geselecteerd.
Het antwoord is te groot of onvolledig	Beperk de vraag. Geef een record, filter of klein aantal resultaten op. Vraag of er meer pagina's overblijven.

Verbreek de verbinding of intrek de toegang

Om de verbinding in één client niet meer te gebruiken, schakel de Azumuta MCP-vermelding daar uit of verwijder deze. Dit maakt de API-sleutel niet ongeldig.

Om de sleutel in te trekken:

Ga naar Management → Devices → API in Azumuta.
Open het rijmenu voor het speciale API-apparaat.
Selecteer Device verwijderen.
Bevestig de verwijdering.

Het verwijderen van het apparaat maakt de sleutel ongeldig voor alle integraties die het gebruiken. Controleer of het apparaat niet wordt gedeeld voordat je het verwijdert. Intrekking verwijdert geen gegevens die al aan een AI-gesprek zijn geretourneerd.