Externe MCP / AI-detectie
Laat een MCP-compatibele assistent aangeleverde tekst analyseren zonder het gesprek te verlaten. De externe server retourneert gestructureerde detectorgegevens via één doelgerichte tool.
export DETECTING_AI_API_KEY="YOUR_API_KEY"
[mcp_servers.detecting_ai]
url = "https://api.detecting-ai.com/api/mcp"
bearer_token_env_var = "DETECTING_AI_API_KEY"
tool_timeout_sec = 300Eén gedeelde externe MCP-server
De detector en humanizer gebruiken hetzelfde Streamable HTTP-endpoint. Deze pagina gaat over de tool detect_ai_text.
https://api.detecting-ai.com/api/mcpMCP-toolcontract
detect_ai_textAnalyseert door de gebruiker aangeleverde tekst op patronen die verband houden met AI-schrijven. De optionele versie-invoer is standaard Detector v3 en de uitvoer bevat details op zinsniveau plus het aantal verwerkte woorden.
Standaard: version = "v3"
| Invoer | Type | Vereist | Beschrijving |
|---|---|---|---|
| idempotency_key | string | Ja | Een URL-veilige sleutel van 16–128 tekens voor deze bewerking. Maak er één per geplande analyse en gebruik die alleen opnieuw voor een exacte nieuwe poging. |
| text | string | Ja | Tekst om te analyseren. De MCP-tool vereist minimaal 10 tekens. |
| version | string | Nee | v1, v2 of v3. De standaardwaarde is v3. |
{
"success": true,
"details": {
"chunks": [
{ "text": "...", "type": "AI", "score": 0.87 }
],
"ai_percentage": 42.5
},
"version": "v3",
"words_processed": 120
}Authenticatie
Kies de authenticatiemethode die je MCP-client ondersteunt. Voeg nooit inloggegevens toe aan de server-URL.
Voeg alleen het MCP-endpoint toe aan een gehoste connector. De client ontdekt de autorisatieservice, opent de aanmelding en toestemming en bewaart daarna zijn eigen toegangstoken.
Bewaar de API-sleutel in een omgevingsvariabele of geheimenopslag. De client verstuurt die als bearer-token wanneer hij de externe server aanroept.
Binnen het gesprek
De tooloproep blijft in de actieve assistent-sessie, waardoor het gemakkelijker wordt om het resultaat te bespreken naast de tekst die het heeft opgeleverd.
Vraag de assistent om een concept, passage of inzending te controleren en duidelijk te maken dat het resultaat menselijke beoordeling ondersteunt.
De client stuurt de tekst naar de externe MCP-server, gebruikt standaard v3 en trekt het gebruik af van de detectorlimiet in je API-abonnement.
Lees het algemene signaal en de zinsfragmenten en bespreek het resultaat daarna samen met concepten, citaten en ander bewijsmateriaal.
MCP-clients
Gehoste connectors voor Claude en ChatGPT gebruiken OAuth. Codex, Claude Code en vergelijkbare lokale clients kunnen een persoonlijke API-sleutel als bearer-token gebruiken.
Voeg het externe endpoint toe als aangepaste connector en voltooi de autorisatie in de browser.
Gebruik een aangepaste MCP-connector met OAuth wanneer de vereiste connectorinstellingen beschikbaar zijn.
Verwijs naar de server-URL en een omgevingsvariabele die het Bearer-token bevat.
Voeg de Streamable HTTP-server toe met een Authorization Bearer-header in de lokale client.
Waar het helpt
MCP beperkt het schakelen tussen toepassingen. De assistent kan de detector aanroepen, gestructureerde gegevens ontvangen en de beoordeling in dezelfde werksessie voortzetten.
Controleer een ingediend concept en vraag daarna om een uitleg per passage van de geretourneerde detectorgegevens.
Gebruik het signaal als onderdeel van een gesprek over bronnen, revisiegeschiedenis en het beleid van de instelling.
Voeg een detectorstap toe aan een beheerst contentproces en stuur onzekere gevallen door voor menselijke controle.
Veelgestelde vragen over MCP
De server werkt op afstand, het gebruik wordt afgetrokken van je API-abonnement en elke tool retourneert gestructureerde gegevens aan de client.
Het is een externe MCP-server via Streamable HTTP die compatibele assistenten toegang geeft tot de tool detect_ai_text. Dezelfde server biedt ook de afzonderlijke tool humanize_text.
Gehoste connectoren voor Claude en ChatGPT kunnen OAuth gebruiken. Codex, Claude Code en andere lokaal geconfigureerde MCP-clients kunnen een Detecting AI-API-sleutel als bearer-token versturen.
De tool retourneert detectordetails, de gebruikte versie en het aantal verwerkte woorden. Het openbare compatibiliteitscontract van Detector v3 gebruikt een ruwe betrouwbaarheidswaarde per fragment van 0 tot 1. ai_percentage is het aandeel invoertekens binnen zinnen met het AI-label, niet het gemiddelde van de fragmentscores.
Nee. Het resultaat is een waarschijnlijkheidssignaal. Gebruik het als aanwijzing voor nader onderzoek van concepten, bronnen, schrijfgeschiedenis en context.
Bij geslaagde aanroepen wordt het aantal ingevoerde woorden afgetrokken van de detectorlimiet van hetzelfde abonnement dat de REST API gebruikt.
Eén server, twee gerichte tools
Lees de volledige installatiehandleiding, vergelijk API-abonnementen of bekijk de andere tool op dezelfde externe server.