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, 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 →

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 #

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:

{
  "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 18 eller senare:

{
  "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 Desktop, Cursor eller en annan MCP-klient, eller Claude API.

ChatGPT kan fortfarande läsa hjälpdokumentationen utan anslutning: se Hjälpdokumentationen är inbyggd 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:

{
  "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 listar vad som stöds.

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.

Klienter med en verktygsbegränsning #

https://mcp.youraiconnector.com/mcp?tags=SubAccounts,Contacts,Messages

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 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.
• “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 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, 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 — generera eller rotera nyckeln som denna anslutning använder.
• Webhooks — den push-baserade motsvarigheten till denna pull-baserade MCP-anslutning.