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

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 #

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:

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

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

ChatGPT kan stadig læse hjælpedokumentationen uden forbindelse: se Hjælpedokumentationen er indbygget 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:

{
  "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 viser, hvad der understøttes.

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.

Klienter med en værktøjsbegrænsning #

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

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 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.
• “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 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, 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 — generer eller roter den nøgle, som denne forbindelse bruger.
• Webhooks — den push-baserede modpart til denne pull-baserede MCP-forbindelse.