Mitä liitännäinen tekee
MCP (Model Context Protocol) on avoin standardi, jonka kautta tekoälyavustaja käyttää toisen järjestelmän työkaluja. PaperOffice tarjoaa tähän etä-MCP-palvelimen. Kun yhteys on luotu, avustaja kuten Claude voi käsitellä dokumentteja PaperOffice:n työtiloissa: haku, lukeminen, tiivistäminen, datan erottaminen, lataaminen, nimeäminen uudelleen, siirtäminen, allekirjoitusten pyytäminen ja työnkulun aloittaminen aina PaperOffice:n käyttöoikeuksien mukaisesti.
Asentamista ei tarvita. Avustaja yhdistetään URL-osoitteeseen, sisäänkirjautuminen suoritetaan PaperOffice:n tilillä ja PaperOffice:n työkalut näkyvät keskustelun sisällä.
Tuetut avustajat ja liitännäisen URL-osoitteet
- Claude (claude.ai, Claude Desktop, Claude Code):
https://mcp.paperoffice.ai/claude, sisäänkirjautuminen OAuth 2.1:lla. - ChatGPT:
https://mcp.paperoffice.ai/chatgpt, sisäänkirjautuminen OAuth 2.1:lla. - Grok:
https://mcp.paperoffice.ai/grok, sisäänkirjautuminen OAuth 2.1:lla. - Cursor:
https://mcp.paperoffice.ai/cursor, henkilökohtaisella käyttäjätunnuksella tai ryhmätunnuksella.
Profiilit viittaavat samaan palvelimeen ja eroavat vain työkalujen laajuudessa.
Tarvittavat edellytykset
- PaperOffice:n tili, jossa on vähintään yksi työtila.
- Credits tilillä. Työkalukutsut laskutetaan API-kutsujen tavoin.
- Avustajan tilaus, joka sallii liitännäiset, esimerkiksi Claude Pro, Max, Team tai Enterprise. Team- ja Enterprise-tilauksissa järjestelmänvalvojan on ehkä otettava liitännäinen käyttöön ensin.
Yhdistä Claude
- Avaa claude.ai:ssa Asetukset → Connectors.
- Valitse Lisää mukautettu liitännäinen, syötä nimi PaperOffice ja URL-osoite
https://mcp.paperoffice.ai/claude. Jätä asiakastunnus ja salaisuus tyhjiksi; OAuth-sisäänkirjautuminen käynnistyy automaattisesti. - Valitse Yhdistä ja kirjaudu sisään PaperOffice:n tilillä. Tarkista pyydetty pääsy ja vahvista se.
- Ota keskustelussa käyttöön PaperOffice:n työkalut.
Claude Desktop käyttää samaa liitännäislistaa kuin claude.ai. Lisää palvelin Claude Codeen komennolla claude mcp add --transport http paperoffice https://mcp.paperoffice.ai/claude ja suorita sisäänkirjautuminen komennolla /mcp.
Ensimmäinen testi: kysy "Mitkä PaperOffice:n työtilat ovat käytettävissä?" Claude:n tulisi luetteloida työtilat.
Yhdistä ChatGPT ja Grok
ChatGPT: Avaa Asetukset → Connectors, lisää mukautettu yhteyspiste nimellä PaperOffice, URL-osoitteella https://mcp.paperoffice.ai/chatgpt ja OAuth-tunnistautumisella, yhdistä sitten ja kirjaudu sisään. Suunnitelman mukaan mukautettujen yhteyspisteiden kehittäjätila saattaa olla otettava käyttöön. ChatGPT-profiili on kuratoitu työkalujen valikoima; se ei sisällä esimerkiksi allekirjoitus- tai työvirtatyökaluja.
Grok: Avaa grok.com/connectors, luo mukautettu yhteyspiste URL-osoitteella https://mcp.paperoffice.ai/grok ja kirjaudu sisään PaperOffice-tilillä ensimmäisen yhdistämisen yhteydessä. Grok-profiili on myös kuratoitu työkalujen valikoima.
Yhdistä Cursor tunnuksella
- Kirjaudu sisään PaperOffice:n sovellukseen ja avaa Tili → API.
- Luo käyttäjätunnus tai käytä ryhmätunnusta järjestelmänvalvojalta. Tunnus näkyy ja sitä voi kopioida API-sivulta milloin tahansa; säilytä se turvallisesti.
- Lisää palvelin Cursor:n mcp.json-tiedostoon URL-osoitteella
https://mcp.paperoffice.ai/cursorja tunnuksena bearer-token Authorization-otsikossa. - Käynnistä Cursor uudelleen tai lataa MCP-palvelimet uudelleen.
Älä koskaan sitoudu mcp.json-tiedostoon, jossa on todellinen token. REST API:n salaiset avaimet ja julkaistavat avaimet on estetty MCP:lle.
Oikeudet: avustaja ei saa enempää kuin käyttäjällä
Avustaja toimii kirjautuneen PaperOffice-käyttäjän oikeuksilla. Työtilan jäsenyys, roolit, jaetut kansiot, säilytyssäännöt (WORM) ja oikeudelliset säilytykset pätevät muuttumattomina. Lue vain -käyttäjä PaperOffice:ssa pysyy lue vain -käyttäjänä avustajassa.
Jokaisella työkalulla on otsikko ja vihje siitä, lukeeko se ainoastaan vai muuttaako se jotakin. Avustaja käyttää näitä vihjeitä kysyäkseen lupaa ennen toimintaa. Poistaminen, roskakorin tyhjentäminen ja allekirjoituspyyntöjen lähettäminen on merkitty tuhoisiksi, joten vahvistuskysymystä odotetaan. Poistetut asiakirjat siirtyvät ensin PaperOffice-roskakoriin ja ne voidaan palauttaa sovelluksessa.
Tiliasetukset, laskutus, käyttäjähallinta ja API-avainten luominen eivät ole saatavilla liittimen kautta. Ne pysyvät PaperOffice-sovelluksessa.
Datavirta: mitä avustaja näkee ja mitä PaperOffice vastaanottaa
- Kirjoitat pyynnön avustajaan.
- Avustaja päättää, mitä PaperOffice-työkalua kutsutaan ja lähettää parametrit, esimerkiksi hakutermin tai asiakirjan tunnuksen, PaperOffice MCP-palvelimelle.
- PaperOffice suorittaa kutsun käyttäjän oikeuksilla ja palauttaa tuloksen, esimerkiksi yhden asiakirjan tekstin tai tiedostonimien luettelon.
- Tulos tulee osaksi keskustelua avustajan kanssa ja sitä käsitellään avustuksen tarjoajan ehtojen mukaisesti.
PaperOffice ei vastaanota chat-historiaa, prompteja tai avustajan vastauksia. Vain työkalukutsu itsensä saavuttaa palvelimen: työkalun nimi, parametrit, aika ja käyttäjä. PaperOffice ei lataa asiakirjoja avustuksen tarjoajalle omasta tahdostaan; tarjoaja vastaanottaa vain sen, mitä avustaja pyysi.
Jokainen työkalukutsu kirjataan ajan, käyttäjän ja Credits-kulutuksen kanssa. Ylläpitäjät näkevät kutsut kohdasta API ja kehittäjä → API-käyttö.
Laskutus
Jokainen liittimen kautta tehty työkalukutsu laskutetaan Credits:ssa, aivan kuten vastaava API-kutsu. Erillistä liitintilausta ei ole. Joitakin tila- ja terveyskyselyitä ei laskuteta; yksityiskohdat ovat API-dokumentaatiossa. Kun Credits:t loppuvat, kutsut hylätään selkeällä viestillä; mitään ei poisteta. Lisää oppaasta laskutuksesta ja Credits:sta: Laskutus ja Credits kohteessa PaperOffice AI.
Peruuta pääsy
- Avustajassa poista tai irrota PaperOffice-liitin. Avustaja lopettaa sen käytön välittömästi; keskustelut, jotka sisältävät jo PaperOffice:n tuloksia, säilyttävät tekstin.
- PaperOffice: Avaa Tili → API. Avustajayhteydet näkyvät tunnusluettelossa MCP-tunnuksella. Poista kyseisen yhteyden tunnusta sieltä.
- Cursor: Kierrä tai poista tunnusta samalla sivulla.
Pääsyn peruuttaminen ei poista mitään dataa.
Vianmääritys
- Kirjautumisikkuna ei avaudu: salli ponnahdusikkunat avustajalle ja yritä yksityistä selaimen ikkunaa. Tiimi- tai Enterprise-suunnitelmissa kysy ylläpitäjältä, onko liitin otettu käyttöön.
- Yhdistetty, mutta PaperOffice-työkaluja ei näy: ota työkalut käyttöön keskustelulle tai aloita uusi keskustelu.
- "Ei valtuutettu" työkalukutsun aikana: yhteys on peruutettu tai vanhentunut. Yhdistä uudelleen. Tokenilla tarkista, että se on käyttäjä- tai ryhmätokeni.
- Avustaja ei löydä asiakirjoja: kysy työtilaluettelo ensin. Yhdistetty käyttäjä ei ehkä ole pääsyssä odotettuun työtilaan. Äskettäin ladatut asiakirjat tarvitsevat hetken, kunnes käsittely on valmis.
- Ei tarpeeksi Credits:tä: lataa uudelleen PaperOffice-sovelluksessa tai ota automaattinen täyttö käyttöön.
Edelleen jumissa? Avaa tukilippu avustajan ja suunnitelman kanssa, tarkka viesti, aika aikavyöhykkeineen ja mahdollisesti kuvakaappaus ilman henkilökohtaisia tietoja.
Suositus IT-tiimeille
- Sallittavat verkkotunnukset: mcp.paperoffice.ai, api.paperoffice.ai ja app.paperoffice.ai. Kaikki liikenne käyttää HTTPS:ää; ei tarvita sisäänmenevää yhteyttä verkkoon.
- Aloita pilottilla: yksi työtila ja lue vain -roolit. Ota kirjoitusroolit käyttöön työtilan perusteella pilotin jälkeen.
- Tarkista API-käyttö säännöllisesti ensimmäisten viikkojen aikana.
Usein kysytyt kysymykset
- Onko asennus vaadittava? Ei. Avustaja yhdistyy URL-osoitteeseen.
- Näkeekö avustaja kaikki asiakirjani? Vain ne, jotka PaperOffice-käyttäjä näkee.
- Lukeeko PaperOffice keskusteluja? Ei. Vain työkalukutsut saapuvat PaperOffice:ään.
- Onko liittymälle erillinen tilaus? Ei. Kutsut laskutetaan Credits:ssa samoin kuin API-kutsut.
- Miten pääsy lopetetaan? Poista yhteyspiste avustajasta ja poista yhteyden tunnus kohdasta Tili → API.