API-integration Beta
API MCP
Giv en AI-klient værktøjer til et API, du allerede bruger, med udgangspunkt i dets OpenAPI-beskrivelse.
Et eksempel med læseadgang
Fra én API-operation til ét værktøj.
Forestil dig en tjeneste med et endpoint, der viser de poster, som tilhører en konto. En AI-klient kan bruge operationen gennem API MCP, uden at der skal skrives en særskilt integration til den.
1. Vælg operationen
GET /widgets
operationId: listWidgets2. Kald det tilgængelige værktøj
list_widgets
query.ownerId: demo-owner3. Læs API’ets svar
200 OK
widgets:
- id: demo-01
name: Desk lampEn opdigtet tjeneste og et eksempel på et svar. Operationen og parametrene følger eksempelkontrakten i projektets repository. Der er ingen forbindelse til en rigtig konto her.
Se API-kontrakten bag eksemplet ↗Beskrivelsen giver værktøjet sin form.
I eksempelkontrakten har GET /widgets operationId listWidgets. Query-parameteren ownerId er påkrævet, mens page er et valgfrit heltal. API MCP udstiller list_widgets med de input.
Læg parameteren det rigtige sted.
Klienten sender kontoens id i query-objektet. API MCP bygger HTTP-kaldet til den valgte destination og tilføjer legitimationsoplysninger via den lokale opsætning.
2. Kald det tilgængelige værktøj
list_widgets
{
"query": {
"ownerId": "demo-owner",
"page": 1
}
}HTTP-kaldet i den opdigtede tjeneste
GET https://api.example.com/v1/widgets
?ownerId=demo-owner&page=1demo-owner er forretningsdata i eksemplet, ikke en API-nøgle. Et token hører til i det valgte miljø eller den understøttede opbevaring af nøgler frem for i dette værktøjsinput.
Et svar skal stadig forstås.
Eksempelsvaret viser én skrivebordslampe. Det viser, hvordan klienten kan få data tilbage, men ikke, at kontoen kun har én genstand. Tjek tjenestens filtrering og sideinddeling, før resultatet kaldes en komplet oversigt.
Hvad sker der ved grænsen?
- Et påkrævet input mangler
- Uden ownerId opfylder kaldet ikke operationens beskrevne input. Få den manglende værdi på plads frem for at opfinde et konto-id.
- Næste kald ville ændre data
- At læse listen giver ikke tilladelse til at oprette en post. Værktøjspolitikken bestemmer, hvilke operationer der er tilgængelige. På understøttede macOS-builds kræver et kald, der ikke er en læsning, også lokal godkendelse.
- Beskrivelsen er ufuldstændig
- En OpenAPI-beskrivelse kan have forkerte felter eller mangle forretningsregler. Et kald kan passe til skemaet og alligevel være uhensigtsmæssigt. Jeg ville afprøve API’ets faktiske adfærd med testdata, før jeg stolede på en ny operation.
Det genbrugelige er at gøre en udtrykkelig API-kontrakt til værktøjer, en klient kan kalde. Valget af konto, et passende udvalg af operationer og en pålidelig forståelse af svaret er stadig en del af integrationen.
Fra API til AI-værktøj.
API MCP gør udvalgte operationer i en OpenAPI 3.x-beskrivelse til værktøjer via Model Context Protocol (MCP). Et værktøjskald bliver sendt videre til det underliggende HTTP-API.
Det kører lokalt mellem en AI-klient, der understøtter MCP, og API’et. Du vælger beskrivelse, destination og adgangsoplysninger samt de operationer, klienten må kalde.
Vælg, hvad klienten må gøre.
Administrerede konfigurationer har kun læseadgang fra start. Du kan aktivere navngivne funktioner eller enkelte endpoints og have forskellige regler for hver kontoprofil. Adgangsoplysninger hentes fra miljøvariabler eller, i understøttede builds til macOS, fra Keychain.
På macOS kræver ændringer af reglerne og API-kald ud over læsning lokal godkendelse i en dialog. Før du tillader ændringer af data, bør du gennemgå API-beskrivelsen og afprøve den med adgangsoplysninger til et testmiljø. En godkendelse fortæller ikke i sig selv, om beskrivelsen er korrekt, eller om et kald passer til dine data.
API MCP er en uafhængig offentlig beta uden tilknytning til de API-udbydere, den forbinder. Repositoryet beskriver understøttede platforme og opsætning. Billy MCP bruger samme tilgang til regnskab.
Spørg mig om API MCP →