1DOX-i ühendus Claude'iga

Mida ühendus teeb

1DOX-i ühendusega saab Claude (ja teised MCP-d toetavad abilised) otsida, lugeda ja kokku võtta ühe 1DOX-i tööruumi dokumente ning soovitada sobivat dokumendimalli. Ühendus on ainult lugemiseks, kui sa ühendamisel ei märgi valikut "Salvestada uusi dokumente ja valmistada ette allkirjataotlusi". Selle valikuga saab abiline ka salvestada teksti uue privaatse dokumendina ja lisada dokumendile allkirjastajaid mustandina. Mõlemal juhul ei muuda, jaga, teisalda ega kustuta see midagi, ei anna digiallkirja ega saada kellelegi midagi: mustandis allkirjastajad vaatad üle ja taotluse saadad sina 1DOX-i portaalis.

Tööriistad

• list_documents — Näitab tööruumi dokumente, uuemad eespool — pealkiri, id ja allkirjastamise seis, ilma tekstita.
• search_documents — Täistekstiotsing üle tööruumi; tagastab lühikesed sobivad lõigud koos dokumendi id-ga.
• get_document — Loeb ühe dokumendi teksti id järgi.
• get_document_details — Näitab dokumendi faili, kuupäevi, kausta, kutsutud allkirjastajaid ja digiallkirju koos kontrolli tulemusega.
• list_folders — Näitab tööruumi kaustu, milles on sulle nähtavaid dokumente.
• get_connection_info — Näitab, kelle nimel ühendus töötab ja millise tööruumiga see on seotud.
• list_templates — Näitab 1DOX-i dokumendimalle (juhatuse koosoleku protokoll, volikiri jne).
• save_document — Ainult muutmisõigusega: salvestab teksti uue privaatse Wordi dokumendina. Olemasolevat dokumenti ei muuda.
• prepare_signature_request — Ainult muutmisõigusega: lisab dokumendile allkirjastajad mustandina. Midagi ei saadeta; taotluse saadad sina 1DOX-is.

Eeldused

• 1DOX-i konto Basic või kõrgema paketiga. Ettevõtte tööruumi puhul peab Basic või kõrgem pakett olema ettevõttel endal.
• Ettevõtte tööruumi jaoks peab ettevõtte administraator (registrijärgne esindaja) esmalt lülitama sisse Selle ettevõtte tehisaru ühendused lehel Seaded → Tehisaru ühendused. Vaikimisi on see välja lülitatud. Isiklik tööruum lülitit ei vaja.
• Iga ühendus näeb täpselt ühte tööruumi — sinu isiklikku või ühe ettevõtte oma, mille liige oled.

Ühendamine claude.ai-s või Claude Desktopis

1. Ava Claude'is Settings → Connectors → „Add custom connector“.
2. Anna nimi (nt 1DOX), sisesta serveri aadressiks https://1dox.eu/api/mcp ja jätka. Jäta Claude'i tuvastatud valikud nii, nagu need on — midagi pole vaja kopeerida.
3. Vajuta „Connect“ ja logi 1DOX-i sisse.
4. Vali 1DOX-i nõusolekuekraanil üks tööruum, mida Claude võib lugeda, ja kinnita.

Ühendamine Claude Code'is

claude mcp add --transport http 1dox https://1dox.eu/api/mcp

Seejärel käivita Claude Code'is /mcp ja vali 1DOX, et brauseris sisse logida.

Ühenduse võti (kliendile, mis saadab päise ise)

Kui klient ei saa brauseris sisse logida, ava Seaded → Tehisaru ühendused, vali vahekaart Käsurida, anna abilisele nimi ja vajuta „Volita“. 1DOX näitab ühenduse võtit (1dox_mcp_…) ja valmis käsku — kopeeri see kohe, võtit näidatakse ainult üks kord:

claude mcp add -s user --transport http 1dox https://1dox.eu/api/mcp --header "Authorization: Bearer 1dox_mcp_…"

Sama serveri aadressi ja Authorization: Bearer päisega saab kasutada iga MCP-klient. Võti ei ole OAuth Client ID ja kehtib, kuni selle tühistad.

Piirangud

Iga ühendust mõõdetakse eraldi, libiseva ajaaknaga: päringud tunnis, loetud erinevad dokumendid 24 tunni jooksul ja edastatud andmemaht 24 tunni jooksul. Otsing tagastab lõike ja on odav; terve dokumendi lugemine läheb arvesse kõige rohkem.

Kui piir saab täis, ütleme abilisele, kui kaua oodata, enne kui uuesti proovida.

Ligipääsu tühistamine

Ava Seaded → Tehisaru ühendused ja vajuta ühenduse juures „Tühista“; abiline kaotab ligipääsu kohe. Ühenduse eemaldamine Claude'is ei tühista seda meie poolel, seega tühista see ka siin. Kui ettevõtte administraator lülitab tehisaru ühendused välja, tühistatakse kõik selle ettevõtte ühendused korraga.

Probleemide lahendamine

• Claude ei saa ühendust või palub uuesti sisse logida — ühendus on tühistatud või selle ligipääs aegunud. Ühenda uuesti ja kontrolli, et aadress oleks täpselt https://1dox.eu/api/mcp.
• „Administraator ei ole tehisaru ühendusi lubanud“ — palu ettevõtte administraatoril need sisse lülitada (vt Eeldused) või ühenda hoopis oma isiklik tööruum.
• Abiline ütleb, et pakett ei sisalda tehisaru ühendusi — tööruumi pakett on Basicust madalam või on aegunud. Vali sobiv pakett ja sama ühendus hakkab jälle tööle.
• Dokumenti ei leita — ühendus näeb ainult nõusolekuekraanil valitud tööruumi. Ühenda uuesti ja vali teine tööruum.
• 1dox_mcp_… võtme kleepimine OAuth Client ID väljale ebaõnnestub — ühenduse võti käib Authorization päisesse, mitte Claude'i OAuth väljadele. Jäta need tuvastatud kujule.
• Piir sai täis — oota abilise teatatud aeg ära või vali suurem pakett.

Privaatsus ja tugi

Dokumentide tekst ja andmed, mille kohta abiliselt küsid, saadetakse selle abilise teenusepakkujale (Claude'i puhul Anthropicule) sinu enda lepingu alusel temaga. Piirangute jälgimiseks logime iga päringu tööriista, dokumendi ja mahu. Vt privaatsuspoliitikat (punkt 9). Küsimused: info@1dox.eu.