Etäkäyttöinen MCP-palvelin

MCP-palvelin, joka täyttää lomakkeen — ei vain lue sitä.

Palvelin toimii etänä: mitään ei tarvitse asentaa, ei Pythonia eikä paikallisia tiedostopolkuja. Claude, ChatGPT, Gemini ja Cursor saavat samat kyvyt kuin iFillPDF-editori — tekoälyn kenttätunnistuksen mihin tahansa PDF:ään, myös skannattuun, ja sen jälkeen täytön, allekirjoituksen, mallipohjat ja liitearkiston.

Yhdistä REST-rajapinta Luo API-avain

Agent callStreamable HTTP

→analyze_pdf(cerfa.pdf)

←schema.fields[] · 18 champs

→fill_pdf({ field_1: … })

✓filled.pdf prêt

Siirtotapa

Streamable HTTP

Tunnistautuminen

OAuth 2.1 tai Bearer

Työkalut

12 työkalua

Yhdistä

Palvelin on etäkäyttöinen: liität vain yhden osoitteen, mitään pakettia ei asenneta eikä paikallista polkua tarvitse määrittää. Se puhuu Streamable HTTP:tä (vanha SSE toimii yhä vanhemmille asiakkaille). Ilmainen tili avaa jo kaikki työkalut — viedyissä tiedostoissa on vain vesileima, ja sen poisto on yksi kertamaksu, ei koskaan tilaus. Valitse asiakasohjelmasi alta; tunnistautuminen hoituu yhdellä klikkauksella.

claude mcp add --transport http ifillpdf https://mcp.ifillpdf.com/mcp

# La première connexion ouvre le flux OAuth iFillPDF dans le navigateur.

Vanha SSE: https://mcp.ifillpdf.com/sse. Jos selainta ei ole käytettävissä (CI, headless-agentit), käytä ifk_live_…-avainta, jonka luot omassa profiilissasi.

Tunnistautuminen ja oikeudet

Kaksi tapaa, jotka tarkistetaan jokaisella pyynnöllä. Joko Supabasen OAuth 2.1 -token — dynaaminen asiakasrekisteröinti ja PKCE, joten useimmat asiakkaat yhdistyvät yhden suostumusruudun jälkeen ilman kopioitavia avaimia — tai pitkäikäinen ifk_live_…-Bearer-avain CI:tä ja headless-ajoja varten. Bearer-avain on palvelutunnus ja saa kaikki alla luetellut oikeudet.

documents:readLire les documents, leur schéma et leurs valeurs.

documents:writeCréer, analyser, remplir et coffrer des documents.

vault:writeAjouter des pièces personnelles au coffre.

templates:readLister et lire les modèles visibles.

templates:writeCréer, dupliquer, modifier et supprimer vos modèles.

Asiakirjasi säilytetään EU:ssa (Frankfurt). Yksi varaus silti: yhdistä palvelin työympäristöön, älä arkaluontoiseen tuotantodataan. Agentit voivat langeta kehotepistokseen (prompt injection) — pidä ihminen mukana päättämässä peruuttamattomista toimista.

Tyypillinen kulku

Agentti ketjuttaa ensin tunnistuksen ja sitten täytön. Juuri tunnistusvaihe erottaa iFillPDF:n tavanomaisista PDF-kirjastoista: se lukee itse sivun eikä AcroForm-kerrosta, joten myös litteä skannaus ilman lomakekenttiä palauttaa kenttäluettelon. Toistuville lomakkeille luot mallipohjan kerran ja käytät sitä jatkossa uudelleen.

1. analyze_pdf      → lähetä PDF, palauttaa schema.fields[] (myös skannaukset)
2. add_to_vault     → (valinnainen) tilitiedot, palkkalaskelma, passi
3. fill_pdf         → täyttää tunnistetut kentät, palauttaa PDF:n
4. use_template     → luo asiakirjan valmiista mallipohjasta

Esimerkkikehotteita

Mitä voit pyytää tavallisella kielellä ja mitkä työkalut se käynnistää.

« Tämä lomake on skannaus ilman täytettäviä kenttiä. Etsi kentät silti ja täytä ne. »

→ analyze_pdf → fill_pdf

« Täytä tämä vuokrasopimus ja tallenna tilitiedot arkistoon seuraavaa kertaa varten. »

→ analyze_pdf → add_to_vault → fill_pdf

« Etsi alihankkijalomakkeen mallipohja ja esitäytä se tälle toimittajalle. »

→ list_templates → use_template → fill_pdf

« Tee analysoidusta sopimuksesta tiimin uudelleenkäytettävä mallipohja. »

→ create_template

Työkalujen hakemisto

Kaksitoista työkalua kolmessa ryhmässä — asiakirjat, arkisto ja mallipohjat. Jokainen tarkistaa oman oikeutensa; puuttuva oikeus palauttaa virheen, joka pyytää hyväksymään yhteyden uudelleen.

Documents (5)

get_documentdocuments:read

Récupère l’état, le schéma et les valeurs d’un document. wait_for_completion attend côté serveur jusqu’à la fin de l’analyse IA.

Inputs

document_id (uuid) · wait_for_completion?

list_documentsdocuments:read

Liste les documents de l’équipe, du plus récent au plus ancien, paginé par curseur.

Inputs

limit (1-100, déf. 20) · cursor? · q? · status? · include_voided?

analyze_pdfdocuments:write

Upload un PDF, détecte chaque champ remplissable et renvoie un schéma structuré (schema.fields[] avec position, label sémantique, type attendu, et rôles dans parties).

Inputs

pdf_base64 (≤4 MB, marche depuis ChatGPT/Claude.ai), pending_upload_id, ou pdf_url · name? · description?

fill_pdfdocuments:write

Remplit les champs détectés et produit le PDF complété. Textes, cases à cocher, nombres, et signatures/images via {dataUrl}.

Inputs

document_id · values (field_id → valeur) · return_format? (url par défaut, base64 pour hôtes sandboxés)

request_pdf_uploaddocuments:write

Renvoie une URL Supabase signée à usage unique pour téléverser des PDF jusqu’à 25 MB, puis appeler analyze_pdf avec pending_upload_id.

Inputs

fileName (.pdf) · sizeBytes (≤ 25 MB)

Coffre (1)

add_to_vaultvault:write

Stocke une pièce personnelle (fiche de paie, RIB, KBIS, passeport) dans le coffre. iFillPDF la réutilise pour pré-remplir les formulaires.

Inputs

file_base64 · file_name · mime_type (pdf/jpeg/png/webp/heic) · label?

Modèles (6)

list_templatestemplates:read

Parcourt la bibliothèque publique (scope=public) ou vos modèles équipe/privés (scope=mine).

Inputs

scope (public | mine) · category? · language? · q? · limit · cursor?

get_templatetemplates:read

Inspecte un modèle (champs, parties, structure). Ne renvoie jamais de valeurs pré-remplies.

Inputs

template_id

create_templatetemplates:write

Fige un document analysé en modèle réutilisable (privé ou équipe). La publication publique est réservée aux admins.

Inputs

source_document_id · name? · description? · category? · tags[]? · language? · visibility? (private | team)

use_templatetemplates:write

Duplique un modèle en nouveau document de travail pré-rempli avec ses valeurs par défaut. Gratuit — ne consomme pas de quota.

Inputs

template_id

update_templatetemplates:write

Met à jour les métadonnées et la visibilité de votre propre modèle. Seul le créateur peut éditer.

Inputs

template_id · name? · description? · category? · tags[]? · language? · visibility? (private | team)

delete_templatetemplates:write

Supprime définitivement votre modèle et ses fichiers. Les documents déjà créés à partir du modèle ne sont pas affectés.

Inputs

template_id

Hiekkalaatikossa toimivat asiakkaat (ChatGPT, Claude.ai, web)

Hiekkalaatikossa toimivat MCP-asiakkaat eivät voi tehdä ulospäin lähteviä HTTP-kutsuja (PUT allekirjoitettuun osoitteeseen, GET latauslinkkiin). Niille tavu-aineisto kulkee itse MCP-kanavan kautta:

Lähetys

analyze_pdf ja pdf_base64 (≤ 4 Mt) request_pdf_uploadin sijaan.

Lataus

fill_pdf ja return_format: "base64" (yli 4 Mt:n tiedostot palautetaan osoitteena).

Paikallisesta CLI-agentista, joka pystyy ulospäin lähteviin kutsuihin, kannattaa käyttää allekirjoitettuja osoitteita ja pending_upload_id-tunnistetta: näin tiedostot voivat olla jopa 25 Mt. Koko REST-sopimus löytyy kehittäjäsivulta ja /openapi.json.