Verbind uw AI-assistent met Azumuta

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

Model Context Protocol (MCP) verbindt uw voorkeurs-AI-assistent met toegestane Azumuta-gegevens. U 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 uw workspace niet wijzigen. Zie Use Azumuta MCP voor voorbeelden en beperkingen.

Voor u begint

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

Cursor is het geïllustreerde voorbeeld in deze guide. Andere AI-assistenten hebben verschillende instellingsbesturingselementen. U hoeft de Azumuta MCP-server niet op uw 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 uw web-app-permissies. Vraag uw beheerder om dit te controleren voordat u verbinding maakt.

1. Maak een speciaal API-apparaat in de workspace die u wilt verbinden.
2. Open Device bewerken voor dat apparaat.
3. Open Veiligheid.
4. Selecteer onder API scopes de optie Beperk deze API key tot een deelverzameling van operaties.
5. Wis de geselecteerde scopes die u niet nodig hebt. De initiële selectie bevat alle scopes.
6. Selecteer alleen de vereiste Read-opties uit de onderstaande tabel.
7. Sla het apparaat op.
8. Kopieer de API-sleutel ervan.

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

Verbind uw voorkeurs-AI-assistent

Voor een workspace op app.azumuta.com gebruikt u deze instellingen:

Vervang <AZUMUTA_API_KEY> door uw 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 gebruikt u het bevestigde MCP-eindpunt ervan.

Voorbeeld: verbinden in Cursor

1. Open Cursor Settings.
2. Open Customize.
3. Selecteer MCPs.
4. Selecteer New MCP Server. Cursor opent het gebruikersniveau mcp.json-configuratiebestand.
5. Voeg de azumuta-vermelding hieronder toe in mcpServers. Behoud eventuele bestaande serveringangen.
6. Vervang <AZUMUTA_API_KEY> door uw speciale sleutel.
7. Sla het bestand op.
8. Ga terug naar Customize → MCPs.
9. Open de Azumuta-serverinstellingen.
10. Als de verbinding is uitgeschakeld, schakelt u deze in.
11. Controleer of de verbinding Connected toont en de verwachte tools opsomt.

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

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

Controleer de verbinding

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

1. Start een nieuw gesprek met uw AI-assistent.
2. Voer in: Use Azumuta MCP to list five work instructions. Include their names and IDs.
3. Als de client goedkeuring aanvraagt, controleer dan de tool en de argumenten ervan voordat u de lezing goedkeurt.
4. 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 de toolrespons en of de workspace toegankelijke werkinstructies bevat.

Doorgaan met voorbeeldvragen en beperkingen.

Verbindingsproblemen

Verbreek de verbinding of trek toegang in

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

De sleutel intrekken:

1. Ga naar Management → Devices → API in Azumuta.
2. Open het rijmenu voor het speciale API-apparaat.
3. Selecteer Device verwijderen.
4. 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 u het verwijdert. Het intrekken verwijdert geen gegevens die al aan een AI-gesprek zijn geretourneerd.