Yhdistä Ringhum Claudeen ja muihin tekoälytyökaluihin (MCP)

Ringhumilla on MCP-palvelin. MCP (Model Context Protocol) on standarditapa tekoälysovelluksille käyttää ulkoisia työkaluja. Kun yhdistät Ringhumin tekoälysovellukseen, kuten Claudeen tai ChatGPT:hen, voit kysyä siltä kysymyksiä työtilastasi tavallisella kielellä. Esimerkiksi: "Tee yhteenveto eilisistä vastaamattomista puheluista", "Ketkä soittajat pyysivät takaisinsoittoa tällä viikolla?" tai "Lisää uudet aukioloaikamme UKK:ihin". Tekoälysovellus toimii samojen sääntöjen ja käyttöoikeuksien mukaisesti kuin Ringhumin rajapinta.

Mitä tarvitset

• Palvelimen osoite: https://ringhum.com/mcp. Se näkyy myös MCP-palvelin -kortissa Kehittäjät-sivulla, Kopioi-painikkeen kanssa.
• Tekoälysovellus, joka tukee etä-MCP-palvelimia, kuten Claude, ChatGPT, Claude Code, Cursor, Windsurf tai VS Code.
• Omistajan tai Ylläpitäjän rooli työtilassa. Vain omistajat ja ylläpitäjät voivat yhdistää sovelluksen tai luoda API-avaimen.

Yhdistämiseen on kaksi tapaa. Kirjautuminen sisään on helpoin ja sopii keskustelusovelluksille, kuten Claudelle ja ChatGPT:lle. API-avain sopii kehittäjätyökaluille, jotka ottavat osoitteen ja otsikon.

Vain luku- tai luku-ja-muutosoikeus

Valitset, kuinka paljon tekoälysovellus saa tehdä.

Vain luku -oikeudella asioita muuttavia työkaluja ei tarjota sovellukselle lainkaan.

Tärkeää: Muutosoikeudella tekoälysovellus voi lähettää oikeita viestejä ja soittaa oikeita puheluita asiakkaillesi. Ringhum merkitsee nämä työkalut työtilasi ulkopuolelle ulottuviksi ja poistot tuhoisiksi, joten useimmat tekoälysovellukset kysyvät sinulta ennen niiden ajamista. Lue, mitä sovellus on aikeissa tehdä, ennen kuin hyväksyt sen.

Yhdistä Claude kirjautumalla sisään

1. Avaa Claudessa (verkossa, työpöydällä tai mobiilissa) Asetukset → Liittimet ja valitse Lisää mukautettu liitin.
2. Liitä https://ringhum.com/mcp osoitteeksi ja tallenna.
3. Napsauta Yhdistä. Ringhum-sivu avautuu. Kirjaudu sisään, jos sinulta kysytään.
4. Yhdistä-sivulla valitse Työtila, jota sovellus saa käyttää.
5. Valitse Mitä se saa tehdä -kohdassa Katso tietoja tai Katso tietoja ja tee muutoksia.
6. Napsauta Salli. Sinut lähetetään takaisin Claudeen.

Sovellus ei koskaan näe salasanaasi. Claudessa tarkat valikkonimet voivat muuttua ajan myötä; etsi liittimiä tai integraatioita sen asetuksista.

ChatGPT: lisää osoite mukautettuna liittimenä (MCP-palvelin) kohdassa Asetukset → Sovellukset ja liittimet, napsauta sitten Yhdistä ja seuraa vaiheita 3–6.

Claude Code: aja alla oleva komento, aja sitten /mcp ja valitse Todenna.

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

Sen jälkeen kun sallit pääsyn, yhteys uusiutuu itsestään niin kauan kuin käytät sitä. Jos sovellusta ei käytetä 90 päivään, sinun täytyy yhdistää se uudelleen.

Yhdistä API-avaimella

Käytä tätä työkaluille, jotka antavat sinun asettaa pyynnön otsikon, tai kun et halua kirjautua sisään.

1. Luo Kehittäjät-sivulla API-avain. Valitse vain read vain luku -yhteyttä varten, tai read ja write salliaksesi muutokset. Katso API-avaimet ja käyttöoikeudet.
2. Lisää palvelin sovellukseesi avaimen kanssa Authorization-otsikossa.

Claude Code:

claude mcp add --transport http ringhum https://ringhum.com/mcp \
  --header "Authorization: Bearer ck_live_…"

Cursor (~/.cursor/mcp.json), Windsurf ja Claude Desktop:

{
  "mcpServers": {
    "ringhum": {
      "url": "https://ringhum.com/mcp",
      "headers": { "Authorization": "Bearer ck_live_…" }
    }
  }
}

VS Code (.vscode/mcp.json):

{
  "servers": {
    "ringhum": {
      "type": "http",
      "url": "https://ringhum.com/mcp",
      "headers": { "Authorization": "Bearer ck_live_…" }
    }
  }
}

Sovellus, joka voi ajaa vain paikallisia palvelimia, voi yhdistää käyttäen npx mcp-remote https://ringhum.com/mcp --header "Authorization: Bearer ck_live_…".

Mitä työkalut kattavat

Jokainen Ringhumin rajapinnan toiminto on saatavilla työkaluna: tilisi ja käyttösi, assistentit, puhelinnumerot, puhelut ja transkriptiot, yhteystiedot, ajanvaraukset ja saatavuus, tilaukset ja tuotteet, huonevaraukset, saapuneet-kansio, tekstiviestit ja WhatsApp-viestit, kampanjat, webhookit, yritysprofiili, palvelut, UKK:t ja tietopankki, vastaamattomat kysymykset, maksulinkit, arvostelupyynnöt, tulot ja roskapostisuoja. Puhelutallenteet ovat ainoa poikkeus: niitä ei ole saatavilla työkaluna.

Jokainen työkalu ajaa vastaavan rajapintapyynnön, joten samat pakettirajat, validointi ja pyyntörajat pätevät. Työkalukutsut lasketaan mukaan rajapinnan 120 pyynnön minuuttirajaan. Täydellinen työkalulista löytyy rajapinnan viiteoppaan MCP-osiosta osoitteessa /docs.

Katso ja katkaise yhdistettyjen sovellusten yhteys

Kirjautumalla yhdistämäsi sovellukset listataan Kehittäjät-sivulla kohdassa Yhdistetyt tekoälysovellukset, kuka ne yhdisti, niiden Käyttöoikeus (Vain luku tai Luku ja muutos) ja milloin niitä viimeksi käytettiin.

Poistaaksesi sovelluksen, napsauta Katkaise yhteys ja vahvista. Se menettää pääsyn välittömästi, ja se täytyy hyväksyä uudelleen. Muuttaaksesi sovelluksen käyttöoikeutta, katkaise sen yhteys ja yhdistä se uudelleen toisella valinnalla.

API-avaimella tehdylle yhteydelle mitätöi avain kohdassa API-avaimet.

Vianetsintä

"Vain työtilan omistajat ja ylläpitäjät voivat yhdistää sovelluksia." Pyydä työtilan omistajaa yhdistämään sovellus, tai tekemään sinusta Ylläpitäjän. Katso Kutsu tiimisi.

"Kirjautumispyyntö vanhentui. Aloita yhdistäminen uudelleen tekoälysovelluksestasi." Hyväksymissivu oli auki liian kauan. Aloita uudelleen tekoälysovelluksesta.

Sovellus sanoo, ettei sillä ole valtuutusta, tai pyytää sinua kirjautumaan sisään uudelleen. Sovelluksen yhteys katkaistiin, avain mitätöitiin, tai et ole enää työtilan jäsen. Yhdistä se uudelleen.

Sovellus ei voi tehdä muutoksia. Se yhdistettiin vain luku -oikeudella, tai sen API-avaimelta puuttuu write-käyttöoikeus.

Sovellus katsoo väärää työtilaa. Pyydä sitä kutsumaan who_am_i tarkistaaksesi. Jokainen yhteys käyttää yhtä työtilaa. Katkaise sen yhteys ja yhdistä uudelleen valitaksesi toisen.