Valitse API kun sovelluksesi tarvitsee käynnistää kyselyt koodisi määrittelemällä tavalla. Valitse MCP, kun haluat yhteensopivan avustajan löytävän ja käyttävän työkaluja keskustelun aikana. Liikkumistiedoissa molemmat tavat voivat toimia samassa tuotteessa.
Päätös koskee palveluun pääsyä, ei luotettavien ja epätarkkojen tietojen välistä valintaa. API ja MCP-palvelin voivat tukeutua samoihin lähteisiin; vertaa niiden sopimuksia, ominaisuuksia ja todellisia rajoitteita.
API: koodisi hallitsee kutsuja
HTTP API:n avulla palvelimesi voi valita reitit, parametrit, hakuaikataulut ja vastauksien käsittelyn. Tämä sopii pysyvään pysäkkiluetteloon, karttasuodattimeen tai aikataulutettuun tehtävään, jonka käyttäytymisen täytyy olla ennustettava.
Sovelluksesi vastaa validoinnista, välimuistista, aikakatkaisuista, virheilmoituksista ja salaisuuksista. API ei estä avustajan rakentamista: voit myös liittää reittejä mallin käyttämiin toimintoihin.
Esimerkki lähialuehausta ROOTE API:lla
MCP: työkalut käytettävissä keskustelussa
MCP-palvelin julkaisee työkalut määriteltyine argumenttischemoineen. Tekoälysovellus löytää ne ja voi käyttää niitä vastaamiseen luonnolliskieliseen kysymykseen. Tämä mahdollistaa yhteensopivien asiakkaiden kytkemisen ilman erillisiä integrointeja kullakin kertaa.
Malli ei saa lisäoikeuksia keksiä parametreja tai tulkita virhettä tyhjänä tuloksena. Asiakkaan ja sovelluksesi on säilytettävä palvelun rajoitteet. Havaitut ominaisuudet pysyvät viitteenä.
Ymmärrä MCP:n virallinen arkkitehtuuri
Valitse haluamasi lopputuloksen mukaan
| Projekti | Alkuvalinta | Miksi |
|---|---|---|
| Pysäkkilista verkkosivulla | API | Koodi hallitsee suodattimet, kutsut ja esityksen |
| Yhteensopiva avustaja hakee osoitteen ympäriltä | MCP | Työkalut ovat keskustelun kautta käytettävissä |
| Jaksollinen vienti tai liiketoiminnan käsittely | API | Skenaario ei riipu keskustelullisesta tulkinnasta |
| Kartta ilman kehitystarvetta käyttöliittymään | Upota ROOTE | Iframe tarjoaa suoran karttakokemuksen |
| Tuote, joka yhdistää kartan ja avustajan | API ja MCP | Jokainen rajapinta vastaa eri vuorovaikutustyyppiin |
Vertaa ominaisuuksia, älä pelkkiä rajapintoja
MCP ROOTE:n Data-työkalut kattavat geokoodauksen, lähialuehaun ja häiriöt transit_disruptionsin avulla. Journey ja Departures eivät ole vielä saatavilla, vaikka REST-sopimus dokumentoi niihin liittyviä reittejä. transit_nearby löytää liikennepaikat; se ei ilmoita niiden seuraavia lähtöjä. Vertaile palvelimen todellisia ilmoituksia.
Suodatinimet, tyypit ja ylärajat voivat myös vaihdella. Esimerkiksi MCP:n transit-tilat ovat merkkijonolista; kartan URL:n tilat on koodattu yhdeksi parametriksi. Älä kopioi asetuksia rajapintojen välillä ilman skeeman tarkistusta.
Arvioi integroinnin työmäärä
API:n kohdalla arvioi vastausten validoinnin, virheenkäsittelyn ja esityksen tarvitsema työ. MCP:n kohdalla tarkista asiakkaan yhteensopivuus, työkalujen löytäminen, avustajan käyttäytyminen ja varoitusten säilyttäminen. Nopea yhteys ei korvaa polkuekyselyjä.
Molemmissa tapauksissa mittaa todelliset kutsut ja noudata palvelun aktiivisia rajoja. Älä lupaa kiinteää hintaa keskustelua kohden ennen kuin olet havainnut haut, uudelleenhakuyritykset ja tilin oikeudet.
Esimerkki: hotelli auttaa vieraitaan liikkumaan
Näyttääkseen pyörä- ja pysäkkikartan hotellin lähellä upotus voi riittää. Personoidun listan tekemiseen sivusto kutsuu palvelinpuolen API:a. Vastaukseen 'missä on wc ja raitiovaunu osoitteeni läheisyydessä?' yhteensopiva avustaja voi hyödyntää MCP:tä.
Nämä polut eivät saa peittää toisiaan: kartta näyttää saatavilla olevat tiedot, lista avaa suodattimensa ja avustaja selittää mitä oikein löysi. Tuntematon palvelu ei katoa siksi, että sen ala puuttuu.
Yhdistä avustajasi MCP ROOTE:n kanssa
Tulossa: seuraavat lähdöt ja reittilaskenta
ROOTE suunnittelee laajentavansa MCP:tään tuleviin lähtöihin ja reitinlaskentaan. Nämä ominaisuudet ovat tulossa, eivätkä vielä kuulu palvelimen tällä hetkellä tarjoamiin työkaluihin. Saatavuuden yhteydessä tarkista palvelimen ilmoittamat työkalut, niiden argumentit ja palautetut tiedot ennen kuin ilmoitat pysähdyksen tai matkan.
Usein kysytyt kysymykset
Korvaako MCP RESTin?
Ei. MCP voi käyttää taustalla REST API:ta, ja sovellus voi pitää REST-integraation rinnalla.
Pitääkö automaatio käyttää MCP:tä?
Ei välttämättä. Jos kutsusarja on määritelty ja toistuva, API riittää yleensä. MCP on hyödyllinen, jos automaatioympäristösi sen tukee tai jos avustaja valitsee työkalut.
Ovatko samat toiminnot käytettävissä kaikkialla?
Tarkista kunkin rajapinnan resurssiluettelo. REST-, MCP- ja karttaominaisuudet eivät ole automaattisesti samanlaisia.