Ako pripojiť Claude k obchodnému softvéru pomocou MCP

Čo pripojenie skutočne je

Sú zapojené tri časti a ich pomenovanie zabraňuje väčšine zmätku neskôr. Hostiteľom je aplikácia Claude. Vo vnútri sa vytvára klient pre každý server, s ktorým sa pripojíte, a tento klient komunikuje presne s jedným serverom. Server je koncový bod MCP obchodného systému, jediná HTTPS URL, ktorá prijíma JSON-RPC správy. Klienti Claude bežia v cloude Anthropic, nie na vašom zariadení, a preto musí byť server prístupný z verejného internetu; systém v súkromnej sieti potrebuje, aby boli adresy Anthropic povolené predtým, ako to všetko funguje.

URL je jediná vec, ktorú potrebujete vedieť vopred. Pre pracovný priestor Sois je to adresa pracovného priestoru nasledovaná: /api/mcpIné produkty zverejňujú svoje v dokumentácii; jedna končí na /sse /sse označuje starší prenos, ktorý Claude stále prijíma, ale ktorý špecifikácia teraz označuje ako zastaraný v prospech Streamable HTTP.

Príručka, minútu po minúte

1. Vložte URLV Claude otvorte prispôsobenie, potom konektory, vyberte Pridať vlastný konektor, dajte mu názov a vložte HTTPS adresu servera. Namiesto toho spustite príkaz mcp add v Claude Code.
2. Claude skúma serverClaude posiela požiadavku bez poverení. Chránený server odpovedá 401 s hlavičkou WWW-Authenticate, ktorá ukazuje na jeho metadata chráneného zdroja. Claude to prečíta a označí nastavenia overenia, ktoré zistil.
3. Claude nájde autorizačný server.Metadata určuje server autorizácie. Claude načíta vlastné metadata tohto servera, aby sa dozvedel o koncových bodoch autorizácie, tokenu a registrácie a o metóde PKCE, ktorú vyžaduje.
4. Claude sa identifikuje.Claude buď predloží dokument s metadátami klienta hosteného spoločnosťou Anthropic, alebo sa zaregistruje dynamicky, alebo použije ID klienta, ktoré ste zadali. Nič nemusíte robiť, pokiaľ ste si nevybrali poslednú možnosť.
5. Prihlásite sa a súhlasíte.Claude otvorí prihlasovaciu stránku systému vo vašom prehliadači. Overíte sa ako vy a schválite zobrazené rozsahy. Systém sa vráti s kódom, Claude ho vymení za token viazaný na tento server a uchová obnovovací token.
6. Claude uvádza nástroje.S pripojeným tokenom Claude zavolá tools/list a získa nástroje, ktoré vám tento systém ponúka. Objavia sa pod konektorom, každý s oprávnením, ktoré môžete nastaviť.
7. Prvý požiadavokPožiadajte o niečo. Claude vyberie nástroje, požiada o schválenie pri prvom volaní každého, pokiaľ ste si nevybrali možnosť Vždy povoliť, a systém skontroluje volanie voči vašim oprávneniam predtým, ako niečo vykoná.

Kroky dva až päť sú tok OAuth 2.1, ktorý špecifikácia autorizácie MCP vyžaduje od HTTP serverov, a dôvod, prečo nie je žiadny token na vloženie. Výzva 401 vyzerá takto na drôte, s adresou metadát a voliteľne s rozsahmi, ktoré server požaduje.

HTTP/1.1 401 Unauthorized
WWW-Authenticate: Bearer resource_metadata="https://acme.sois.ai/.well-known/oauth-protected-resource",
                  scope="mcp"

Výzva, ktorú pracovný priestor Sois vracia neautentifikovanému klientovi. Klient nasleduje adresu resource_metadata, aby objavil server autorizácie; hodnota rozsahu je najmenšie oprávnenie, ktoré by mal najprv požiadať.

Dve protokolové pravidlá vás tu chránia bez vášho zapojenia. Klient musí požiadať o token pre tento konkrétny server, pričom použije parameter resource z RFC 8707, a server musí odmietnuť tokeny vydané pre čokoľvek iné, takže token pre jeden systém nemôže byť znovu použitý voči inému. A server nikdy nesmie odovzdať váš token tretej službe. Špecifikácia považuje obidve za tvrdé požiadavky, nie odporúčania.

Výber metódy prihlásenia

Dialóg na pridanie vlastného konektora v Claude ponúka malý súbor možností, keď preskúma URL. Väčšina ľudí nikdy nezmení to, čo zistí, ale je dobré vedieť, čo každá možnosť znamená, pretože nastavenia overenia nemôžu byť neskôr upravené; na ich zmenu musíte konektor odstrániť a pridať ho znova.

Pre plány Team a Enterprise je tvar rovnaký s jedným extra krokom: vlastník pridá konektor v nastaveniach organizácie a každý člen sa potom pripojí a prihlási ako sám pod prispôsobením. Vlastník rozhoduje, ktoré servery existujú; akcie člena stále nesú autoritu člena.

Čo Claude vidí po pripojení

Zoznam nástrojov je celé rozhranie. Každý záznam má názov, popis a vstupnú schému, a Claudeov model používa popisy na rozhodovanie, ktorý nástroj požiadavka potrebuje, a schému na vyplnenie argumentov. Na pracovisku Sois je zoznam filtrovaný podľa vašej úlohy a aplikácií nainštalovaných pred jeho vrátením, takže používateľ financií vidí nástroje ako vyhľadávanieFaktúr, vytvoriť faktúru, zaznamenaťPlatbu a poslaťPripomienkyFaktúr, alongside the contacts, inbox, calendar and task tools everyone has, and does not see the administrative tools at all. The specification permits exactly this: a server may vary the list by the credentials on the request.

Claude potom na to aplikuje svoje vlastné ovládacie prvky. Pod konektorom môžete nastaviť akýkoľvek nástroj na Blokované, takže model ho nikdy nevidí. V chate každé volanie nástroja žiada o schválenie, pokiaľ ste pre ten nástroj nevybrali Možno vždy, čo Anthropic odporúča rezervovať pre servery, ktorým dôverujete. Výskumné funkcie môžu vyvolať nástroje konektora bez pýtania, takže odporúčanie je vypnúť nástroje na písanie na konektore, kým prebieha výskumný beh.

To isté pripojenie z Claude Code a API

V Claude Code je príkaz: claude mcp add --transport http sois https://your-workspace.sois.ai/api/mcpServer je predvolene uložený v lokálnom rozsahu; --rozsah projekt zapíše to do .mcp.json môžete sa zaviazať za tím a --rozsah používateľ sprístupňuje ho v každom projekte. Spustite /mcp na prihlásenie cez prehliadač, alebo claude mcp prihlásenie sois z terminálu. Konektory, ktoré už boli pridané na claude.ai, sa automaticky objavia v Claude Code pod rovnakým účtom a administrátori môžu označiť jednotlivé nástroje ako povolené alebo zablokované.

API správ je iného druhu. Jeho MCP konektor, v beta verzii za mcp-client-2025-11-20 hlavička, prijíma URL servera v mcp_servery vstup a mcp nástrojový set v poli nástrojov a podporuje iba volania nástrojov. Neexistuje žiadny prehliadačový tok: prístupový token OAuth získate sami a odovzdáte ho ako autorizácia token, aktualizovaním podľa potreby. To vyhovuje službe, ktorú prevádzkujete v mene používateľov, ktorých ste už overili. Je to nesprávna cesta na poskytnutie pripojenia koncovému používateľovi, na čo existuje vlastný konektor.

Čo môže Claude robiť

Po prechádzke je užitočná otázka nie, či je Claude pripojený, ale čo môže pripojenie robiť, a odpoveď je stanovená serverom. Na Sois je odpoveďou oprávnenie osoby, ktoré je vynútené dvakrát: raz pri zostavovaní zoznamu nástrojov, raz pri vykonávaní každého volania. Token bol vydaný vám, takže každá akcia je pripísaná vám v denníku pracovného priestoru so svojimi vstupmi a výsledkom, presne ako by to bolo u osoby. Výdavky sú obmedzené na každú integráciu, kde vlastný agent pracovného priestoru vykonáva prácu; keď Claude vykonáva uvažovanie, ako to robí cez toto pripojenie, pracovný priestor nevykonáva žiadnu AI vo vašom mene a za to si nič neúčtuje.

To je to, čo robí rozumným nechať model konať: oprávnenia sú tie, ktoré podnik už udržiava pre ľudí, a pripojenie ich zdedí.

Keď niečo nejde podľa plánu

• Prihlásenie sa opakuje alebo zlyháva. Takmer vždy je to URL: cesta, ktorá nie je koncovým bodom MCP, alebo server, ktorý nie je dostupný z verejného internetu. Skontrolujte adresu v dokumentácii systému a potvrďte, že odpovedá 401 s hlavičkou WWW-Authenticate.
• Nástroje chýbajú. Zoznam je filtrovaný podľa vašej úlohy. Ak kolega vidí nástroj, ktorý vy nevidíte, rozdiel sú oprávnenia v podnikovom systéme, nie konektor.
• Hovor je odmietnutý. Prečítajte si chybu, ktorú hlási Claude. Odmietnutie oprávnenia znamená, že osoba, pod ktorou ste sa prihlásili, to nemôže urobiť; chyba validácie znamená, že model môže opraviť vstup a skúsiť to znova.

Otázky, ktoré sa ľudia pýtajú.

Tento článok sa prehodnocuje, keď sa zmenia produkty, ktoré popisuje. Ďalšie naplánované prehodnotenie: 4. decembra 2026.