# Forbind AI-assistenter (MCP) Your AI Connector leverer en officiel **MCP-server** — et Model Context Protocol-endepunkt, der lader AI-assistenter som **Claude Code**, **Claude Desktop**, **Cursor** og dine egne apps styre din Your AI Connector-konto direkte. Spørg på almindeligt sprog ("list mine AI-agenter", "tilføj dette lead", "hvad kostede AI mig i denne uge?") og assistenten kalder Your AI Connector API'et for dig. Det er den samme v1 API, som du tilgår med en [API-nøgle](api-access.md), godkendt med din egen API-nøgle. MCP-serveren bygger ét værktøj til hver handling i vores publicerede API-specifikation, så den dækker det meste, men ikke alt, af v1 API'en: kontakter, beskeder, kampagner, AI-agenter, brugerdefinerede funktioner, vidensbase, aftaler, analyse, tags, lister, udsendelser, handler, kanaltilslutninger og underkonti. Automatiseringer kan listes og læses, men endnu ikke oprettes eller redigeres via MCP; opret dem i appen. Inden for det, den eksponerer, er der ingen tilladelser pr. værktøj og ingen skrivebeskyttet standard, så API-nøglen er hele adgangskontrollen. - **Slutpunkt:** `https://mcp.youraiconnector.com/mcp` - **Godkendelse:** din Your AI Connector API-nøgle (sendes som `X-API-Key`-header) - **Kræver:** et abonnement med API-adgang. [Opret en API-nøgle →](api-access.md#generating-your-api-key) > Din API-nøgle fungerer på **din egen konto** med de samme tilladelser som resten af API'en — og kan læse de klientkonti, du administrerer, hvis du har en bureauplan (se nedenfor). Behandl den som en adgangskode. Du kan til enhver tid tilbagekalde den under Indstillinger → Integrationer → API-nøgle, hvilket øjeblikkeligt afbryder assistentens adgang. ## Claude Code ```bash claude mcp add --transport http ai-connector https://mcp.youraiconnector.com/mcp \ --header "X-API-Key: YOUR_API_KEY" ``` Kør derefter `/mcp` inde i Claude Code for at bekræfte, at den viser **ai-connector ✓ connected**. Som standard tilføjes serveren med **lokalt** omfang (kun dig, dette projekt). Brug `--scope user` for at gøre den tilgængelig i alle dine projekter, eller `--scope project` to commit it to a repo's `.mcp.json` for dit team: ```json { "mcpServers": { "ai-connector": { "type": "http", "url": "https://mcp.youraiconnector.com/mcp", "headers": { "X-API-Key": "YOUR_API_KEY" } } } } ``` ## Claude Desktop Tilføj serveren som en brugerdefineret connector. Den opsættes på din Claude-konto, så den virker både i Claude Desktop og på claude.ai (gratis Claude-konti kan tilføje én brugerdefineret connector). 1. Åbn **Customize → Connectors**, klik på **+ Add**, og derefter **Add custom connector**. 2. Giv den et navn og indtast `https://mcp.youraiconnector.com/mcp` som URL. 3. Under **Authentication**, vælg **No sign in**. MCP-serveren har ingen loginside: hvis du vælger en logindeling, ender det med fejlen "Couldn't register with … sign-in service". 4. Under **Request headers**, tilføj en header med navnet `X-API-Key` med din API-nøgle som værdi. 5. Klik på **Add**. Your AI Connector værktøjer vises i værktøjsmenuen i en ny chat. **Intet felt til Request headers?** Din version af Claude Desktop er for gammel: opdatér den, eller brug konfigurationsfilen i stedet. Konfigurationsfilen (`claude_desktop_config.json`, Settings → Developer → Edit Config) kører kun programmer på din computer og ignorerer en `url`-indgang, så den kræver den lille `mcp-remote`-bro, som kræver [Node.js](https://nodejs.org) 18 eller nyere: ```json { "mcpServers": { "ai-connector": { "command": "npx", "args": [ "-y", "mcp-remote", "https://mcp.youraiconnector.com/mcp", "--header", "X-API-Key:${AI_CONNECTOR_KEY}" ], "env": { "AI_CONNECTOR_KEY": "YOUR_API_KEY" } } } } ``` Behold `X-API-Key:${AI_CONNECTOR_KEY}` præcis som skrevet, uden mellemrum efter kolonet (på Windows opdeler et mellemrum headeren), og indsæt kun din nøgle i `env`. Afslut derefter Claude Desktop helt (på Windows, højreklik på proceslinjeikonet → Quit) og åbn det igen. ## ChatGPT ChatGPT kan ikke oprette forbindelse til MCP-serveren i øjeblikket. Dens brugerdefinerede connector-formular tilbyder kun **OAuth** eller **Ingen godkendelse**, og Your AI Connector MCP-serveren logger ind med din API-nøgle, som sendes som en anmodningsheader. Hvis du vælger OAuth, fejler det med "kunne ikke finde OAuth-indstillinger", og Ingen godkendelse bliver afvist, fordi hver anmodning kræver nøglen. Brug en assistent, der lader dig indstille en anmodningsheader i stedet: [Claude Code](#claude-code), [Claude Desktop](#claude-desktop), [Cursor eller en anden MCP-klient](#cursor--other-mcp-clients) eller [Claude API'et](#the-claude-api-build-it-into-your-own-app). ChatGPT kan stadig læse hjælpedokumentationen uden forbindelse: se [Hjælpedokumentationen er indbygget](#the-help-docs-are-built-in) for de offentlige `llms.txt`-filer. ## Cursor & andre MCP-klienter De fleste MCP-kompatible editorer bruger den samme `.mcp.json`-form, som vist ovenfor (en HTTP-server med en `url` og en `X-API-Key`-header). Tilføj en `ai-connector`-server, der peger på `https://mcp.youraiconnector.com/mcp`, og indsæt din API-nøgle i headeren. ## Claude API (indbyg det i din egen app) Du kan forbinde MCP-serveren programmatisk med Claude API'ets MCP- connector, så en agent, du bygger, kan bruge Your AI Connector-værktøjer uden en separat klient: ```json { "model": "claude-opus-4-8", "messages": [{ "role": "user", "content": "List my AI agents" }], "mcp_servers": [ { "type": "url", "name": "ai-connector", "url": "https://mcp.youraiconnector.com/mcp", "authorization_token": "YOUR_API_KEY" } ] } ``` ## Hvad du kan gøre Inden for den del af v1-API'en, som MCP-serveren eksponerer, vælger assistenten automatisk det rigtige værktøj: - **AI-agenter:** list, opret, opdater, pause/genoptag, inspicer konfiguration. - **Kontakter:** søg, opret, tag, tilføj til lister, importer. - **Vidensbase / FAQ'er:** tilføj, rediger, masseimport, godkend AI-forslag. - **Beskeder:** læs samtaler, send en besked til en kontakt. - **Aftaler:** list, book, annuller. - **Opgaver:** opret, fuldfør, list. - **Analyse:** beskedstatistik, kreditforbrug, AI-omkostninger. - **Kanaler:** tjek forbindelsesstatus, start et forbindelsesflow. ## Spørgsmål om dine klienters konti (bureauer) Én forbindelse dækker alle de konti, du administrerer. Du skal ikke tilføje en ekstra forbindelse pr. klient: På en bureauplan kan assistenten læse enhver klientkonto under dig, så du kan spørge om dem alle i én samtale. Du skal blot nævne klienten: - "Hvor mange kontakter har Bella's Bistro?" - "Hvad kostede AI hver af mine klienter i denne uge?" - "Hvad er status for Northside Dentals kanaler, og hvor mange chats kom der ind i denne uge?" Dette dækker læsning af kontakter, beskeder, chats, kampagner, aftaler, opgaver, tags, begivenheder, ofte stillede spørgsmål, vidensbasekilder, telefonnumre, kanaler, webhooks og analyse. Vi tjekker, at kontoen rent faktisk er din, før noget køres — hvis du spørger efter en, der ikke er din, returneres "ikke fundet". Udelad klienten, og assistenten læser din egen konto, præcis som før. **Ændring af en klients konto** fungerer på samme måde. Enhver handling, der accepterer en klientkonto i API'et, er tilgængelig for en navngiven klient: opsætning af AI-agenter, vidensbase, brugerdefinerede funktioner, WhatsApp-skabeloner, indgangspunkter, kanalforbindelser, kontakter, tags, udsendelser, aftaler, handler og opgaver samt afsendelse af beskeder. Undtagelserne er handlinger på bureau-niveau, som altid kører på din egen bureaukonto: administration af selve klientkontiene (grænser, funktioner, prissætning, pause), snapshots, dit team og API-nøgler. Tilføjelse af kontakter til eller fjernelse af dem fra en klients liste er endnu ikke tilgængeligt for en navngiven klient; gør dette fra den pågældende klients egen nøgle eller i deres konto. [Guiden til bureau-API'et](../agency/api-for-agencies.md#where-sub_account_id-is-supported) viser, hvad der understøttes. ::: neutral-mcp Bureauværktøjerne findes kun på den standardiserede, ikke-brandede adresse, `https://mcp.youraiconnector.com/mcp`. En white-label MCP-adresse på dit eget domæne (`mcp.youragency.com`) er bygget til dine kunder og udelader disse, så opret forbindelse med den standardiserede, ikke-brandede adresse, når du administrerer kundekonti. ::: Dette er også svaret til en klient, der driver **flere virksomheder under ét login**. Giv hver virksomhed sin egen konto, og inviter derefter klientens e-mail som teammedlem på dem alle: De logger ind én gang og skifter mellem deres brands med kontovælgeren i sidepanelet. ### Test af en klients agent Bed assistenten om at afprøve en klients agent ("send 'leverer I om søndagen?' til Bakery-agenten hos klient X, og vis mig, hvad den gjorde"). Den sender en Afprøv-besked med din bureau-nøgle og klientens `sub_account_id`, venter og læser svaret samt eventuelle handlinger, som agenten foretog sig. Der kræves ingen kopi af agenten. Hvis assistenten siger, at du ikke har en bureau-konto, er den forbundet med en klients nøgle: forbind den igen med din bureau-kontos nøgle. Se [Afprøv](../chats/playground.md#testing-an-agent-from-the-api-or-an-ai-assistant). ## Klienter med en værktøjsbegrænsning ::: neutral-mcp Nogle AI-klienter accepterer kun en server med et begrænset antal værktøjer. Composio afviser for eksempel en server, der viser mere end 500 værktøjer, og importerer ingen af dem. Den fulde agentforbindelse viser flere end det, så tilføj `?tags=` til adressen med kun de grupper af værktøjer, du har brug for. For en agent, der ønsker at vise sine klientkonti, læse deres kontakter, chats og beskeder samt sende beskeder: ``` https://mcp.youraiconnector.com/mcp?tags=SubAccounts,Contacts,Messages ``` Det indlæser omkring 80 værktøjer. Navngiv klienten i din anmodning, og assistenten handler på den pågældende klients konto, som beskrevet ovenfor. - Adskil grupper med kommaer; både store og små bogstaver fungerer. - For at tilføje enkelte værktøjer skal du angive deres nøjagtige navne med `tools=`, for eksempel `?tags=Contacts&tools=list_or_get_subaccounts`. Du får alle værktøjer fra begge lister. - Hjælpedokumenternes værktøjer er altid inkluderet. - API-nøglen skal stadig placeres i `X-API-Key`-headeren (eller `Authorization: Bearer YOUR_API_KEY`), aldrig i adressen. ::: ## Hjælpedokumentationen er indbygget MCP-serveren giver assistenten din **konto** og denne **dokumentation**. Tre værktøjer læser hjælpedokumenterne live, så assistenten kan slå op, hvordan en funktion fungerer, eller hvad der for nylig er ændret, i stedet for at gætte: - `docs_search`: finder de sektioner, der besvarer et spørgsmål, og returnerer dem med sidelinket. - `docs_read`: læser én side i fuld længde eller én sektion af den. - `docs_list`: viser alle sider opdelt efter område. Der er intet, der skal opsættes, og dokumentationsværktøjerne rører aldrig dine kontodata. Spørg "hvordan fungerer entry points?" eller "hvad er nyt i automatiseringer?", og assistenten søger først i dokumentationen. Fordi værktøjerne læser selve hjælpesiden, kender din assistent en funktion, så snart dens guide er publiceret. En assistent, der ikke er forbundet via MCP, kan stadig læse dokumentationen: peg den mod `https://docs.youraiconnector.com/llms.txt` (et indeks over alle hjælpesider med et link til hver sides Markdown-version) eller `https://docs.youraiconnector.com/llms-full.txt` (hele dokumentationen i én Markdown-fil). Begge er offentlige, kræver ingen nøgle og genopbygges ved hver ændring i dokumentationen. ## Find eller generer din API-nøgle Den API-nøgle, som denne forbindelse bruger, findes under **Indstillinger → Integrationer → API-nøgle** — dens egen sektion, adskilt fra Webhooks. Se [API-adgang](api-access.md#generating-your-api-key) for de præcise trin. ## Fejlfinding - **"Connection refused" eller "not found"** — adressen mangler `/mcp` til sidst. Brug `https://mcp.youraiconnector.com/mcp`, ikke `https://mcp.youraiconnector.com`. - **`Needs authentication` / 401** — din API-nøgle mangler eller er forkert. Tilføj serveren igen med en gyldig `X-API-Key`. - **"Could not discover OAuth settings" (ChatGPT)** — ChatGPT understøtter kun OAuth eller ingen godkendelse for brugerdefinerede connectorer, og MCP-serveren bruger en API-nøgle, så ChatGPT kan ikke oprette forbindelse i øjeblikket. Se [ChatGPT](#chatgpt). - **"Couldn't register with … sign-in service" eller "add an OAuth Client ID" (Claude Desktop)** — den brugerdefinerede connector blev tilføjet med en logindeling. Der er intet OAuth-klient-id at indtaste: fjern connectoren og tilføj den igen med **Authentication → No sign in** og din API-nøgle som en `X-API-Key`-request header, som beskrevet i [Claude Desktop](#claude-desktop). - **Claude Desktop viser ingen værktøjer efter redigering af konfigurationsfilen** — konfigurationsfilen ignorerer en `"url"`-indgang; brug den brugerdefinerede connector eller `mcp-remote`-formularen i [Claude Desktop](#claude-desktop), og afslut og genåbn appen helt. - **Et værktøj returnerer `403`** — dit abonnement eller din teamrolle tillader ikke den handling; MCP-serveren håndhæver ikke noget ekstra, det er den samme tilladelseskontrol som API'en. - **Værktøj ikke fundet** — værktøjslisten genereres live fra API'en, så den matcher altid den aktuelle version; genopret forbindelsen for at opdatere. - **En sikkerheds- eller certifikatadvarsel på dit eget domæne** — at pege en DNS-post mod os er ikke nok i sig selv: underdomænet skal også verificeres i dashboardet, før det kan levere en sikker forbindelse. White-label-bureauer kan placere MCP-adressen på deres eget domæne (f.eks. `mcp.youragency.com`) fra **Custom domain**-kortet under **Settings → White Labeling** — tilføj CNAME hos din registrar først, indtast derefter værtsnavnet i **MCP domain (AI assistants)**-blokken og klik på **Verify**, samme proces som for dine andre branded underdomæner. Den branded adresse udelader bureauværktøjerne; fortsæt med at bruge den standard, ikke-branded adresse til disse. Indtil din branded adresse er verificeret, skal du bruge den standard, ikke-branded adresse: den er sikker at dele med klienter. --- ## Næste skridt - [API-adgang](api-access.md) — generer eller roter den nøgle, som denne forbindelse bruger. - [Webhooks](webhooks.md) — den push-baserede modpart til denne pull-baserede MCP-forbindelse.