Los problemen op met OAuth-aanmelding, toegang tot het verkeerde account, ontbrekende tools, fouten door alleen-lezen, conflicten en onvolledige rapportgeneratie.
Open eerst hetzelfde account in Unify en controleer of de site of het item daar toegankelijk is. Vraag de assistent vervolgens om portal_guide aan te roepenportal_guide. Hiermee maakt u onderscheid tussen een probleem met portaaltoegang en een niet-verbonden AI-tool.
| De external signal-driver meldt | Controle en volgende stap |
|---|---|
| Geen optie om een aangepaste verbinding toe te voegen | Controleer het connectorbeleid en het beschikbare abonnement van de AI-werkruimte. Gebruik de actuele installatiestappen voor ChatGPT of Claude. |
| De server-URL wordt geweigerd | Voer https://unify.eniris.com/bff/mcp exact. /mcp is de portaalpagina; dit is niet het MCP-eindpunt. |
| Het openen van het eindpunt in een browser toont geen webpagina | Het eindpunt is een protocolservice. Voeg het via het MCP-verbindingsvenster van de client toe met OAuth; een browserpagina als antwoord is geen verbindingstest. |
| Er wordt in de chat om een wachtwoord, API-sleutel of statisch token gevraagd | Stop met deze aanpak. Start de OAuth-aanmelding vanuit de verbindingsinstellingen. Plak nooit persoonlijke aanmeldgegevens in een gesprek. |
| Autorisatieverzoek verlopen | Start opnieuw vanuit de AI-client. Een oud goedkeuringstabblad kan niet onbeperkt opnieuw worden gebruikt. |
| Verbonden, maar de assistent geeft alleen algemene antwoorden | Schakel Unify in of selecteer Unify in dat gesprek en vraag expliciet om portal_guide aan te roepen. Controleer of er daadwerkelijk een tool is aangeroepen. |
| Eerder verbonden, nu niet geautoriseerd | Controleren MCP → My connections. Meld u opnieuw aan en maak opnieuw verbinding als de oorspronkelijke sessie is verlopen, u zich hebt afgemeld of de toegang is ingetrokken. |
| Een nieuw geïntroduceerde tool ontbreekt | Vernieuw de toollijst van de client of maak opnieuw verbinding. Controleer ook of de werkruimte of het gesprek de tool heeft uitgeschakeld. |
| De external signal-driver meldt | Controle en volgende stap |
|---|---|
| De assistent toont het verkeerde account | Lees portal_guide. Autoriseer opnieuw voor het gewenste account. Van account wisselen in een browser verandert een bestaande verbinding niet. |
| Een site ontbreekt | Zoek in de lijst met geautoriseerde sites en ga door met bladeren door de pagina's. Vergelijk de toegang met hetzelfde persoonlijke account in Unify. Gebruik geen site-ID uit het gesprek van een andere gebruiker. |
| Lezen werkt, maar opslaan mislukt | Controleer of de verbinding bewerken toestaat en of u dat object in Unify kunt bewerken. Beide zijn vereist. |
| Een formulevoorbeeld werkt, maar opslaan mislukt | Een voorbeeld opslaan gebeurt niet. Voor het opslaan van de accountformulecatalogus zijn zowel rechten voor accountinstellingen als bewerkingsrechten nodig. |
| De assistent zegt dat alarmregels of gebruikers niet kunnen worden bewerkt | Deze bewerkingen vallen buiten de huidige MCP-toolset. Gebruik het relevante portaalscherm. |
| Een andere collega heeft toegang tot meer gegevens | Elke verbinding gebruikt de rechten van de persoon die toestemming heeft gegeven. Controleer het lidmaatschap en de sitetoegang via gebruikersbeheer. |
Als een resultaat ontbreekt, vraag dan naar de bron, de periode en het meettijdstip. Maak onderscheid tussen een niet-beschikbare waarde en een gemeten nul. PR vereist ook geschikte invoer en een betekenisvolle periode; MCP inschakelen creëert geen ontbrekende PV-configuratie of telemetrie.
Beperk de taak bij grote accounts eerst tot één site of een kleine batch voordat u uitbreidt. Gebruik dagwaarden voor een maandoverzicht en een fijnere resolutie voor een kort onderzoek. Vraag niet herhaaldelijk naar elke meting van elke site met de fijnste resolutie.
De meettool accepteert maximaal 24 meterkeys per aanroep en een periode van maximaal 366 dagen. Gebruik batches en geschikte tijdsintervallen. Een gepagineerd antwoord moet worden gevolgd totdat de gevraagde selectie compleet is; vermeld uitsluitingen expliciet.
Een revisieconflict betekent dat het object is gewijzigd nadat het was uitgelezen. Vraag de assistent de nieuwste definitie op te halen, niet-gerelateerde wijzigingen te behouden en alleen de bedoelde wijziging opnieuw toe te passen. Verzin geen revisienummer en gebruik het oude volledige document niet opnieuw.
Lees het object na een time-out tijdens het schrijven uit voordat u het opnieuw probeert. De server kan het opslaan hebben voltooid, ook al heeft het antwoord de client niet bereikt. Dit is belangrijk voor nieuwe rapporten, notities en grafieken, die anders kunnen worden gedupliceerd.
Vermeld de AI-client, het geschatte tijdstip en de tijdzone, de uitgevoerde actie, de fouttekst, het verbonden account en de ID's van de betrokken site of rapporten. Geef aan of dezelfde actie in Unify werkt en of de verbinding alleen lezen toestaat of bewerken toestaat.
Vermeld geen wachtwoorden, toegangstokens, vernieuwingstokens, autorisatiecodes of privé-callback-URL's die aanmeldgegevens bevatten. Verberg bij schermafbeeldingen niet-gerelateerde sitegegevens en persoonlijke informatie.
MCP: praktische workflows en prompts
Uitgewerkte prompts voor productieonderzoeken, batter diagnostiek, bewerkingen van grafieken, PV-rapporten, PDF's en aangepaste KPI-formules.
MCP: gereedschapreferentie en aanvraagconventies
Verwijs naar de beschikbare lees- en schrijfgereedschappen, rapportformaten, accountomvang, identificaties, revisiecontroles en meetlimieten.