OpenAI
Gids MCP
Wat is een MCP-server?
Een MCP-server stelt gestructureerde tools beschikbaar aan een AI-client. Met Foliade kan Codex of Claude Code een PDF converteren, de link ervan ophalen en de statistieken raadplegen zonder handmatig API-aanroepen te kopiëren.
Een gemeenschappelijke server, twee plug-ins
Dezelfde gehoste server verbindt Codex en Claude Code met uw account. Beide plug-ins bieden instructies voor het veilig overbrengen van een lokale PDF.
Een applicatie die de REST-API gebruikt, moet een accountsleutel opgeven. MCP gebruikt OAuth voor je account, of een privétoken beperkt tot de upload in gastmodus.
Voordat je begint
MCP is gratis inbegrepen, met of zonder account. Codex en Claude Code volgen de rechten van je abonnement; hun eigen toegangsvoorwaarden staan daar los van.
Installeer de plug-in, koppel uw account en autoriseer toegang. Er zijn geen lokale servers, geen API-sleutels en geen Python-installatie vereist.
Je account verbinden in Codex
Het installeren van de plugin verbindt je account nog niet. Voer na de installatie deze opdracht uit in de terminal van je computer, buiten het Codex-gesprek:
codex mcp login foliade
Op de geopende Foliade-pagina logt u in, verifieert u het accountadres en autoriseert u de verbinding. Ga dan terug naar uw wizard.
Als de browser niet opent, open dan de link die in de terminal verschijnt. Deel deze aanmeldlink niet.
Wacht op de bevestiging in de terminal dat het aanmelden is gelukt voordat je verdergaat. Je hoeft geen API-sleutel te kopiëren.
De verbinding controleren en je eerste PDF versturen · Installatie Claude Code
Een lokale PDF overbrengen
De externe server kan een pad op uw computer niet lezen. De plug-in berekent de grootte en SHA-256-vingerafdruk van het gekozen bestand, bereidt een storting voor, verzendt de bytes via HTTPS en voltooit vervolgens het concept.
De conversie is asynchroon. De assistent controleert het resultaat voordat hij het succes aankondigt. Publieke publicatie vereist een aparte actie; het concept blijft standaard privé.
Toegang beheren en intrekken
In Foliade → API → Verbonden assistenten kunt u elke verbinding intrekken. De toegang stopt onmiddellijk, zonder uw catalogi te verwijderen.
Deze handleidingen hebben betrekking op Codex en Claude Code met toegang tot lokale bestanden. Ze garanderen niet de overdracht van bijlagen naar ChatGPT, Claude web, Claude Desktop of Cowork.
Plug-in ingeschakeld, maar MCP-tools niet beschikbaar
Het kan zijn dat een ingeschakelde plug-in nog steeds geen verbinding kan maken met de server. Controleer de MCP-status en foutmelding voordat u de plug-in opnieuw installeert of uw account opnieuw koppelt.
- Als de server niet kan worden gevonden, controleer dan of de plug-in is geïnstalleerd en ingeschakeld.
- Als de verbinding de opstarttime-out overschrijdt, controleer dan de MCP-logboeken. Een time-out na 30 seconden bewijst niet dat uw OAuth-verbinding is verlopen.
- Als een Cloudflare 403-antwoord fout 1010 of browser_signature_banned meldt, blokkeert Browser Integrity Check de HTTP-client voordat deze Foliade bereikt. Het verhogen van de opstarttime-out lost deze afwijzing niet op.
- Als Foliade 401 of invalid_token retourneert, koppelt u uw account opnieuw via OAuth. Vervang deze verbinding niet door gasttoegang.
Wat moet ik doen als Cloudflare de verbinding blokkeert?
Neem voor de gehoste Foliade-service contact op met ons ondersteuningsteam en geef de tijd en tijdzone, de betreffende URL, de foutcode en Cloudflare Ray ID door, indien weergegeven. Stuur geen tokens, cookies, inloglinks of privédocumenten. Er zijn geen Cloudflare-instellingen die u op uw computer kunt wijzigen.
Servicestatus · Neem contact op met Foliade-ondersteuning
Nadat de server is gerepareerd, start u uw assistent opnieuw op om de MCP-tools opnieuw te laden en vraagt u hem vervolgens om het verbonden Foliade-account te controleren. Verstuur de PDF pas zodra de tools beschikbaar zijn en het account-e-mailadres is bevestigd.
Voor serveroperators: repareer Browser Integrity Check
Deze procedure is bedoeld voor de Cloudflare-beheerder van de server. Controleer eerst of Browser Integrity Check de afwijzing heeft veroorzaakt; een time-out op zichzelf kan een andere oorzaak hebben.
- Open in Cloudflare de serverzone en vervolgens Regels → Configuratieregels. Maak een regel met een aangepaste expressie die beperkt is tot de hostnaam en de routes MCP en OAuth.
- Voeg alleen de instelling Browser Integrity Check toe en schakel deze uit in deze regel. Behoud de andere beveiligingen, authenticatie en limieten voor verzoeken.
Expressie gebruikt voor de Foliade-server. Pas voor een andere server de hostnaam en routes aan de implementatie ervan aan:
(http.host eq "foliade.gekkode.com" and (
http.request.uri.path in {
"/mcp" "/authorize" "/token" "/register" "/revoke"
"/.well-known/oauth-authorization-server"
"/.well-known/oauth-protected-resource"
"/.well-known/oauth-protected-resource/mcp"
}
or starts_with(http.request.uri.path, "/mcp/uploads/")
))
Test na de implementatie met dezelfde HTTP-client: de aanroepen initialize en tools/list en het ophalen van OAuth-metadata moeten slagen. Foliade geeft een lijst met 35 tools terug; toegang tot catalogi zonder authenticatie moet nog steeds 401 retourneren.
Om terug te draaien, schakelt u alleen deze regel uit. Vermijd het wereldwijd uitschakelen van Cloudflare-beveiligingen of het wijzigen van de user-agent om het probleem te verbergen.
Cloudflare: fout 1010 · Cloudflare: schakel deze controle uit voor specifieke routes
Anthropic