# Anslut AI-assistenter (MCP) Your AI Connector levererar en officiell **MCP-server** — en Model Context Protocol-slutpunkt som låter AI-assistenter som **Claude Code**, **Claude Desktop**, **Cursor** och dina egna appar styra ditt Your AI Connector-konto direkt. Fråga på vanligt språk ("lista mina AI-agenter", "lägg till detta lead", "vad kostade AI mig den här veckan?") och assistenten anropar Your AI Connector-API:et åt dig. Det är samma v1-API som du når med en [API-nyckel](api-access.md), autentiserad med din egen API-nyckel. MCP-servern bygger ett verktyg för varje åtgärd i vår publicerade API-specifikation, så den täcker det mesta, men inte allt, av v1-API:et: kontakter, meddelanden, kampanjer, AI-agenter, anpassade funktioner, kunskapsbas, möten, analys, taggar, listor, sändningar, affärer, kanalanslutningar och underkonton. Automatiseringar kan listas och läsas, men ännu inte skapas eller redigeras via MCP; bygg dessa i appen. Inom det som exponeras finns inga behörigheter per verktyg och ingen skrivskyddad standard, så API-nyckeln utgör hela åtkomstkontrollen. - **Slutpunkt:** `https://mcp.youraiconnector.com/mcp` - **Autentisering:** din Your AI Connector API-nyckel (skickas som `X-API-Key`-huvud) - **Kräver:** en plan med API-åtkomst. [Skapa en API-nyckel →](api-access.md#generating-your-api-key) > Din API-nyckel agerar på **ditt eget konto**, med samma behörigheter som > resten av API:et — och kan läsa klientkonton som du hanterar, om du har en > byråplan (se nedan). Behandla den som ett lösenord. Du kan när som helst återkalla den via > Inställningar → Integrationer → API-nyckel, vilket omedelbart bryter assistentens åtkomst. ## Claude Code ```bash claude mcp add --transport http ai-connector https://mcp.youraiconnector.com/mcp \ --header "X-API-Key: YOUR_API_KEY" ``` Kör sedan `/mcp` inuti Claude Code för att bekräfta att den visar **ai-connector ✓ connected**. Som standard läggs servern till med **lokal** omfattning (endast du, detta projekt). Använd `--scope user` för att göra den tillgänglig i alla dina projekt, eller `--scope project` to commit it to a repo's `.mcp.json` för ditt team: ```json { "mcpServers": { "ai-connector": { "type": "http", "url": "https://mcp.youraiconnector.com/mcp", "headers": { "X-API-Key": "YOUR_API_KEY" } } } } ``` ## Claude Desktop Lägg till servern som en anpassad anslutning (custom connector). Den ställs in i ditt Claude-konto, så den fungerar i både Claude Desktop och på claude.ai (gratis Claude-konton kan lägga till en anpassad anslutning). 1. Öppna **Customize → Connectors**, klicka på **+ Add** och sedan på **Add custom connector**. 2. Ge den ett namn och ange `https://mcp.youraiconnector.com/mcp` som URL. 3. Under **Authentication**, välj **No sign in**. MCP-servern har ingen inloggningssida: att välja ett inloggningsalternativ leder till "Couldn't register with … sign-in service". 4. Under **Request headers**, lägg till en rubrik (header) med namnet `X-API-Key` och din API-nyckel som värde. 5. Klicka på **Add**. Your AI Connector verktyg visas i verktygsmenyn i en ny chatt. **Inget fält för Request headers?** Din version av Claude Desktop är för gammal: uppdatera den eller använd konfigurationsfilen istället. Konfigurationsfilen (`claude_desktop_config.json`, Settings → Developer → Edit Config) kör endast program på din dator och ignorerar en `url`-post, så den behöver den lilla `mcp-remote`-bryggan, vilket kräver [Node.js](https://nodejs.org) 18 eller senare: ```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" } } } } ``` Behåll `X-API-Key:${AI_CONNECTOR_KEY}` exakt som det är skrivet, utan mellanslag efter kolon (på Windows delar ett mellanslag upp rubriken), och placera din nyckel endast i `env`. Avsluta sedan Claude Desktop helt (på Windows, högerklicka på ikonfältet → Quit) och öppna det igen. ## ChatGPT ChatGPT kan för tillfället inte ansluta till MCP-servern. Dess formulär för anpassade anslutningar erbjuder endast **OAuth** eller **Ingen autentisering**, och Your AI Connector MCP- servern loggar in med din API-nyckel, som skickas som en begärandehuvud (request header). Att välja OAuth misslyckas med "could not discover OAuth settings", och Ingen autentisering avvisas eftersom varje anrop kräver nyckeln. Använd en assistent som låter dig ställa in ett begärandehuvud istället: [Claude Code](#claude-code), [Claude Desktop](#claude-desktop), [Cursor eller en annan MCP-klient](#cursor--other-mcp-clients), eller [Claude API](#the-claude-api-build-it-into-your-own-app). ChatGPT kan fortfarande läsa hjälpdokumentationen utan anslutning: se [Hjälpdokumentationen är inbyggd](#the-help-docs-are-built-in) för de publika `llms.txt`-filerna. ## Cursor och andra MCP-klienter De flesta MCP-kompatibla redigerare använder samma `.mcp.json`-format som visas ovan (en HTTP-server med en `url` och ett `X-API-Key`-huvud). Lägg till en `ai-connector`-server som pekar på `https://mcp.youraiconnector.com/mcp` och klistra in din API-nyckel i huvudet. ## Claude API (bygg in det i din egen app) Du kan ansluta MCP-servern programmatiskt med Claude API:ets MCP- anslutning, så att en agent du bygger kan använda Your AI Connector-verktyg utan 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" } ] } ``` ## Vad du kan göra Inom den del av v1-API:et som MCP-servern exponerar väljer assistenten rätt verktyg automatiskt: - **AI-agenter:** lista, skapa, uppdatera, pausa/återuppta, inspektera konfiguration. - **Kontakter:** sök, skapa, tagga, lägg till i listor, importera. - **Kunskapsbas / FAQ:** lägg till, redigera, massimportera, godkänn AI-förslag. - **Meddelanden:** läs konversationer, skicka ett meddelande till en kontakt. - **Bokningar:** lista, boka, avboka. - **Uppgifter:** skapa, slutför, lista. - **Analys:** meddelandestatistik, kreditförbrukning, AI-kostnad. - **Kanaler:** kontrollera anslutningsstatus, starta ett anslutningsflöde. ## Frågor om dina klienters konton (byråer) En anslutning täcker varje konto du hanterar. Du behöver inte lägga till en andra anslutning per klient: på en byråplan kan assistenten läsa alla klientkonton under dig, så du kan ställa frågor om alla i en och samma konversation. Ange bara klientens namn: - "Hur många kontakter har Bella's Bistro?" - "Vad kostade AI för var och en av mina klienter den här veckan?" - "Vad är status för Northside Dentals kanaler, och hur många chattar kom in den här veckan?" Detta omfattar läsning av kontakter, meddelanden, chattar, kampanjer, möten, uppgifter, taggar, händelser, vanliga frågor, kunskapsbaskällor, telefonnummer, kanaler, webhooks och analys. Vi kontrollerar att kontot verkligen är ditt innan något körs — om du frågar efter ett konto som inte är det returneras "hittades ej". Utelämna klienten så läser assistenten ditt eget konto, precis som tidigare. **Att ändra en klients konto** fungerar på samma sätt. Varje åtgärd som accepterar ett klientkonto i API:et är tillgänglig för en namngiven klient: att ställa in AI-agenter, kunskapsbas, anpassade funktioner, WhatsApp-mallar, ingångspunkter, kanalanslutningar, kontakter, taggar, utskick, möten, affärer och uppgifter, samt att skicka meddelanden. Undantagen är åtgärder på byrånivå, som alltid körs på ditt eget byråkonto: att hantera själva klientkontona (gränser, funktioner, prissättning, pausning), snapshots, ditt team och API-nycklar. Att lägga till eller ta bort kontakter från en klients lista är ännu inte tillgängligt för en namngiven klient; gör det från klientens egen nyckel eller i deras konto. [Guiden för byrå-API](../agency/api-for-agencies.md#where-sub_account_id-is-supported) listar vad som stöds. ::: neutral-mcp Byråverktygen finns endast på den vanliga, icke-varumärkesprofilerade adressen, `https://mcp.youraiconnector.com/mcp`. En white-label MCP-adress på din egen domän (`mcp.youragency.com`) är byggd för dina klienter och exkluderar dessa verktyg, så anslut med den vanliga, icke-varumärkesprofilerade adressen när du hanterar klientkonton. ::: Detta är också svaret för en klient som driver **flera företag under en inloggning**. Ge varje företag ett eget konto och bjud sedan in klientens e-postadress som teammedlem på alla: de loggar in en gång och växlar mellan sina varumärken med kontoväljaren i sidofältet. ### Testa en klients agent Be assistenten att testa en klients agent ("skicka 'levererar ni på söndagar?' till Bakery-agenten hos klient X och visa mig vad den gjorde"). Den skickar ett testmeddelande med din byrånivånyckel och klientens `sub_account_id`, väntar och läser tillbaka svaret samt eventuella åtgärder som agenten vidtog. Ingen kopia av agenten behövs. Om assistenten säger att du inte har ett byråkonto är den ansluten med en klients nyckel: återanslut den med ditt byråkontos nyckel. Se [Testa](../chats/playground.md#testing-an-agent-from-the-api-or-an-ai-assistant). ## Klienter med en verktygsbegränsning ::: neutral-mcp Vissa AI-klienter accepterar endast en server med ett begränsat antal verktyg. Composio vägrar till exempel en server som listar fler än 500 verktyg och importerar inga av dem. Den fullständiga agentanslutningen listar fler än så, så lägg till `?tags=` i adressen med endast de grupper av verktyg du behöver. För en agent som vill lista sina klientkonton, läsa deras kontakter, chattar och meddelanden, samt skicka meddelanden: ``` https://mcp.youraiconnector.com/mcp?tags=SubAccounts,Contacts,Messages ``` Det laddar cirka 80 verktyg. Namnge klienten i din förfrågan så agerar assistenten på den klientens konto, enligt beskrivningen ovan. - Separera grupper med kommatecken; både stora och små bokstäver fungerar. - För att lägga till enskilda verktyg, lista deras exakta namn med `tools=`, till exempel `?tags=Contacts&tools=list_or_get_subaccounts`. Du får varje verktyg från båda listorna. - Hjälpdokumentens verktyg inkluderas alltid. - API-nyckeln placeras fortfarande i `X-API-Key`-huvudet (eller `Authorization: Bearer YOUR_API_KEY`), aldrig i adressen. ::: ## Hjälpdokumentationen är inbyggd MCP-servern ger assistenten tillgång till ditt **konto** och denna **dokumentation**. Tre verktyg läser hjälpdokumentationen live, så att assistenten kan slå upp hur en funktion fungerar, eller vad som nyligen ändrats, istället för att gissa: - `docs_search`: hittar de avsnitt som besvarar en fråga och returnerar dem med sidlänken. - `docs_read`: läser en sida i sin helhet, eller ett avsnitt av den. - `docs_list`: listar varje sida per område. Det finns inget att konfigurera, och dokumentationsverktygen rör aldrig din kontodata. Fråga "hur fungerar startpunkter?" eller "vad är nytt inom automatiseringar?" så söker assistenten i dokumentationen först. Eftersom verktygen läser själva hjälpsidan, känner assistenten till en funktion så snart dess guide har publicerats. En assistent som inte är ansluten via MCP kan fortfarande läsa dokumentationen: peka den mot `https://docs.youraiconnector.com/llms.txt` (ett index över varje hjälpsida med en länk till varje sidas Markdown-version) eller `https://docs.youraiconnector.com/llms-full.txt` (hela dokumentationen i en Markdown-fil). Båda är publika, kräver ingen nyckel och återskapas vid varje ändring i dokumentationen. ## Hitta eller generera din API-nyckel API-nyckeln som denna anslutning använder finns under **Inställningar → Integrationer → API-nyckel** — en egen sektion, separat från Webhooks. Se [API-åtkomst](api-access.md#generating-your-api-key) för de exakta stegen. ## Felsökning - **"Connection refused" eller "not found"** — adressen saknar `/mcp` i slutet. Använd `https://mcp.youraiconnector.com/mcp`, inte `https://mcp.youraiconnector.com`. - **`Needs authentication` / 401** — din API-nyckel saknas eller är felaktig. Lägg till servern igen med en giltig `X-API-Key`. - **"Could not discover OAuth settings" (ChatGPT)** — ChatGPT stöder endast OAuth eller ingen autentisering för anpassade anslutningar, och MCP-servern använder en API-nyckel, så ChatGPT kan inte ansluta för tillfället. Se [ChatGPT](#chatgpt). - **"Couldn't register with … sign-in service" eller "add an OAuth Client ID" (Claude Desktop)** — den anpassade anslutningen lades till med ett inloggningsalternativ. Det finns inget OAuth-klient-ID att ange: ta bort anslutningen och lägg till den igen med **Authentication → No sign in** och din API-nyckel som en `X-API-Key`-begäran-rubrik, som i [Claude Desktop](#claude-desktop). - **Claude Desktop visar inga verktyg efter redigering av konfigurationsfilen** — konfigurationsfilen ignorerar en `"url"`-post; använd den anpassade anslutningen eller `mcp-remote`-formuläret i [Claude Desktop](#claude-desktop), och avsluta samt öppna appen igen. - **Ett verktyg returnerar `403`** — din plan eller din roll i teamet tillåter inte den åtgärden; MCP-servern framtvingar inget extra, det är samma behörighetskontroll som för API:et. - **Verktyg hittades inte** — verktygslistan genereras live från API:et, så den matchar alltid den aktuella versionen; återanslut för att uppdatera. - **En säkerhets- eller certifikatvarning på din egen domän** — att peka en DNS-post mot oss räcker inte i sig: underdomänen måste också verifieras i kontrollpanelen innan den kan tillhandahålla en säker anslutning. White-label-byråer kan placera MCP-adressen på sin egen domän (t.ex. `mcp.youragency.com`) från kortet **Custom domain** under **Settings → White Labeling** — lägg till CNAME hos din registrar först, ange sedan värdnamnet i blocket **MCP domain (AI assistants)** och klicka på **Verify**, samma flöde som för dina andra varumärkesanpassade underdomäner. Den varumärkesanpassade adressen utelämnar byråverktygen; fortsätt använda den vanliga, icke-varumärkesanpassade adressen för dessa. Tills din varumärkesanpassade adress är verifierad, använd den vanliga, icke-varumärkesanpassade adressen: den är säker att dela med klienter. --- ## Nästa steg - [API-åtkomst](api-access.md) — generera eller rotera nyckeln som denna anslutning använder. - [Webhooks](webhooks.md) — den push-baserade motsvarigheten till denna pull-baserade MCP-anslutning.