Anslut din AI med MCP eller CLI

Innan ni börjar

En ägare eller administratör behöver först aktivera AI-åtkomst i varje organisation. Medlemmar kan sedan ansluta sin egen AI. Godkännandet ger aldrig större behörighet än användarens vanliga roll.

CLI betyder kommandoradsverktyg. Det körs i en terminal på din dator eller i den AI-miljö du väljer. Det stöder kontakter, listor och att skapa utskicksutkast. Att skicka mejl eller utskick, radera uppgifter, hantera betalningar eller ändra organisationens behörigheter ingår inte.

Administratör: aktivera organisationen

Listadministration kräver fortfarande ägare eller administratör. En medlem kan läsa godkända listor och arbeta med kontakter inom sin egen behörighet.

1. Öppna Inställningar → Anslutna appar på webben eller i en appversion som har funktionen.
2. Välj organisationen och aktivera Tillåt medlemmar att ansluta sin AI.
3. Välj vilka läs- och skrivbehörigheter organisationen tillåter och spara. Upprepa för fler organisationer om det behövs.

Anslut utan terminal med MCP

MCP låter en AI-tjänst ansluta direkt till CRM utan att du installerar Node.js eller CLI. AI-tjänsten behöver stödja externa MCP-anslutningar med inloggning. Stödet och var anslutningen läggs till varierar mellan tjänster och abonnemang.

När MCP är tillgängligt för er visas en MCP-adress under Inställningar → Anslutna appar på webben och i appversioner som har guiden. Om adressen saknas kan du använda CLI-guiden nedan.

1. Kopiera MCP-adressen från Inställningar → Anslutna appar.
2. Lägg till adressen som en extern MCP-anslutning i din AI-tjänst och starta anslutningen där.
3. Logga in på CRM:s godkännandesida i webbläsaren. Kontrollera vilken AI-tjänst du återvänder till. Godkänn bara en anslutning du själv startat.
4. Välj en eller flera organisationer och granska behörigheterna för var och en. Skrivbehörigheter, inklusive Skapa utskicksutkast, måste väljas aktivt.
5. Bekräfta ditt val och återvänd till AI-tjänsten. Be AI:n visa vilka företag och behörigheter den har fått innan den gör ändringar.

Arbeta med din anslutna AI

Börja exempelvis med: Visa vilka företag jag har anslutit. Fråga vilket jag vill arbeta med och visa sedan företagets kontaktlistor. Ändra inget.

För ett utskicksutkast kan du be: Skapa ett utkast med rubrik, brödtext, avdelare och en knapp till vår hemsida. Visa länken så att jag kan granska brevet i CRM. Ange vilket företag du menar. AI:n behöver behörigheten Skapa utskicksutkast.

MCP kan arbeta med godkända kontakter och listor och skapa nya utskicksutkast. Mottagare väljs i CRM. Att skapa ett utkast skickar inga mejl och kostar inga utskickstokens. Granska alltid innehåll, avsändare och mottagare själv.

Åtkomsten hanteras under Inställningar → Anslutna appar, precis som för CLI. För utökad åtkomst: återkalla den gamla anslutningen, anslut på nytt från AI-tjänsten och godkänn de nya behörigheterna. En administratörs ändring ger aldrig automatiskt din AI fler rättigheter.

Installera CLI på din dator

Du behöver Node.js 22 eller senare och npm i den miljö där din AI arbetar. Under Inställningar → Anslutna appar finns nu en guide med en färdig instruktion att ge till din AI. Det kräver en AI som kan köra terminalkommandon; en vanlig chatt utan terminalstöd räcker inte. Vill du göra det själv? Kommandona nedan hämtar det officiella paketet direkt från CRM de la Crème. Har du en äldre version kan du köra samma installationskommando för att uppdatera till 0.2.1. Uppdateringen behåller din anslutning; nya behörigheter kräver ett separat godkännande.

npm install --global https://crmcreme.com/downloads/crmcreme-cli-0.2.1.tgz
crmcreme login --name "Min AI"

Ladda ned CLI 0.2.1 · Kontrollsumma

Godkänn flera organisationer samtidigt

Du kan även skriva in terminalens kod under Inställningar → Anslutna appar → Godkänn en CLI-kod i mobilappen. På en dator utan webbläsare kan du köra crmcreme login --no-browser och öppna den visade adressen på din egen dator.

Standardinloggningen begär bara läsbehörighet. För att begära ändringar använder du kommandot nedan; organisationens inställningar och din roll avgör vad du kan godkänna.

CLI 0.2.1 visar efter inloggningen organizations med varje företags faktiska scopes och missingRequestedScopes. connected: true betyder att anslutningen sparats, inte att alla begärda behörigheter beviljats. Om permissionsVerified är false behöver du köra crmcreme organizations för att kontrollera åtkomsten. Behörigheterna kan skilja sig mellan företag och ändras senare.

1. Inloggningen öppnar CRM:s godkännandesida. Logga in med ditt eget konto.
2. Kontrollera att koden på sidan stämmer med koden i terminalen. Godkänn aldrig en kod som någon annan har skickat.
3. Markera de organisationer som din AI ska få tillgång till. Organisationer som inte aktiverat tjänsten är låsta.
4. Granska behörigheterna för varje organisation. Läsbehörigheter är förvalda när du markerar organisationen; skrivbehörigheter måste väljas aktivt.
5. Bekräfta att du själv startade anslutningen och välj Godkänn valda organisationer. Återvänd sedan till terminalen.

crmcreme login --name "Min AI" --scope contacts:read,contacts:write,lists:read,lists:write

Välj rätt organisation i varje kommando

När terminalen bekräftar anslutningen kan du be din AI: Visa vilka företag jag har anslutit till CRM de la Crème. Fråga vilket jag vill arbeta med. Visa sedan namnen på företagets kontaktlistor om min anslutning tillåter det. Ändra inget.

Kör organizations för att se godkända organisationer och deras ID. Ange sedan ett av dessa ID efter --org. Ersätt ORGANISATIONS_ID, KONTAKT_ID och LIST_ID i exemplen med de riktiga värdena. Resultatet är JSON, som din AI kan läsa som data.

Om ett svar innehåller nextCursor finns fler resultat. Kör samma listkommando med --cursor och det värdet för att läsa nästa sida.

crmcreme organizations
crmcreme contacts list --org ORGANISATIONS_ID
crmcreme contacts get KONTAKT_ID --org ORGANISATIONS_ID
crmcreme lists list --org ORGANISATIONS_ID
crmcreme lists members LIST_ID --org ORGANISATIONS_ID

Skapa och ändra med godkänd skrivbehörighet

Spara kontaktuppgifter i en JSON-fil. För en ny kontakt behövs email; name, phone och company är frivilliga. Uppdateringar behöver details med name, phone och company samt expectedRevision från den senast lästa kontakten. Skicka alla tre textfält för att bevara värden som inte ska ändras. E-postadressen ändras inte via detta kommando.

När en kontakt läggs till i en lista via CLI aktiveras inget utskickssamtycke. Befintliga avregistreringar och spärrar bevaras. Listmedlemskap är inte samma sak som tillstånd att skicka nyhetsbrev.

crmcreme contacts create --org ORGANISATIONS_ID --data kontakt.json
crmcreme contacts update KONTAKT_ID --org ORGANISATIONS_ID --data ändring.json
crmcreme lists create --org ORGANISATIONS_ID --name "Intressenter"
crmcreme lists add LIST_ID --org ORGANISATIONS_ID --contact KONTAKT_ID

Låt din AI förbereda ett utskicksutkast

En administratör behöver tillåta Skapa utskicksutkast i organisationens AI-inställningar. Du behöver sedan godkänna samma behörighet för din egen anslutning. Befintliga anslutningar får den inte automatiskt.

Installera CLI 0.2.1 enligt steget ovan. Logga ut en befintlig anslutning och anslut på nytt med kommandot nedan. Välj företag och godkänn behörigheten själv. Detta exempel ger bara rätt att skapa utkast.

Be AI:n fylla i exempelfilens namn, ämnesrad, förhandsvisning, företagsnamn och innehåll. Låt listIds vara tom tills mottagarlistorna har valts i CRM. Ersätt FÖRETAGETS_ID med rätt ID från crmcreme organizations. Exemplet innehåller rubrik, text, avdelare och knapp. Byt knappens exempeladress mot din egen HTTPS-adress.

Svaret innehåller reviewUrl, en fullständig länk till utkastet, samt reviewPath för klienter som använder en relativ sökväg. Öppna länken eller hitta utkastet under Utskick i CRM och granska innehåll, avsändare och mottagare. Att skapa utkastet kostar inga utskickstokens och skickar inga mejl. AI:n kan inte läsa eller ändra befintliga brev med denna behörighet.

Behåll campaignId i filen när samma skapande behöver göras om efter ett nätverksfel. Ett nytt brev ska få ett nytt ID genom ett nytt exempel. Ändringar i ett redan sparat utkast görs i CRM.

crmcreme login --name "Min AI" --scope campaigns:create
crmcreme organizations
crmcreme campaigns example > utkast.json
crmcreme campaigns create --org FÖRETAGETS_ID --data utkast.json

Bygg brevet med sektioner

Varje objekt i content.sections behöver ett eget id i UUID-format och en type. Högst 30 sektioner får användas. Behåll deras id när du försöker spara samma utkast igen. Godtycklig HTML stöds inte.

heading: text är rubriken (högst 200 tecken). text: text är brödtexten (högst 6 000 tecken); använd radbrytningar för stycken. divider: en avdelare, utan extra fält.

button: label är knapptexten (högst 100 tecken), url är en fullständig HTTPS-adress. Valfri align är left, center eller right.

image: url är bildens HTTPS-adress och alt är bildbeskrivningen (högst 300 tecken). imageText har dessutom text och imageSide (left eller right). Tom bildadress kan sparas som platshållare men behöver fyllas i före utskick.

products: products är en lista med 1–3 produktkort. Varje kort har ett eget id (UUID), title, url, image, price och label. title är högst 200 tecken, price och label högst 100. Använd HTTPS-adresser för länkar och bilder; image och price kan vara null. En tom produktlänk behöver fyllas i före utskick.

Lägg till objekten nedan i content.sections och ge varje ny sektion ett nytt UUID. Byt exempeladressen till företagets egen sida.

[
  {
    "id": "10000000-0000-4000-8000-000000000001",
    "type": "divider"
  },
  {
    "id": "10000000-0000-4000-8000-000000000002",
    "type": "button",
    "label": "Besök vår hemsida",
    "url": "https://example.com",
    "align": "left"
  }
]

Ändra eller återkalla åtkomst

När administratören tillåter en ny behörighet får befintliga AI-anslutningar den inte automatiskt. Kör crmcreme logout, logga in igen med --scope och godkänn önskade behörigheter för varje företag. Ange även de tidigare behörigheter du vill behålla: --scope ersätter standardvalet. Detta skapar en ny anslutning; välj därför åter alla företag du vill ansluta. Kontrollera sedan scopes i crmcreme organizations. Anslutningen gäller högst 30 dagar.

Exemplet nedan begär samtliga fem behörigheter. Ta bort dem du inte behöver. Minskad eller återkallad åtkomst gäller utan ny inloggning.

Återkallelse stoppar nya anrop. Redan godkända anrop kan hinna slutföras. Att aktivera organisationen igen ger inte tillbaka tidigare återkallad åtkomst. Borttaget medlemskap och begränsade roller påverkar också AI:ns åtkomst.

1. Öppna Inställningar → Anslutna appar och leta upp din anslutning.
2. Avmarkera behörigheter och spara för att begränsa åtkomsten. Avmarkera allt för att återkalla en organisations åtkomst.
3. Välj Återkalla hela anslutningen för att stoppa den i alla organisationer. Du kan också köra crmcreme logout i terminalen.
4. En administratör kan återkalla en medlems AI-åtkomst till den egna organisationen eller stänga av tjänsten för hela organisationen.

crmcreme logout
crmcreme login --name "Min AI" --scope contacts:read,contacts:write,lists:read,lists:write,campaigns:create
crmcreme organizations

Kontrollera aktivitet och hantera fel

Under Aktivitet och organisationens anslutningar ser du dina händelser. Administratörer kan se organisationens anslutningar och aktivitet. En godkänd åtkomstkontroll betyder att appen fick försöka utföra kommandot, inte att en senare ändring säkert lyckades.

Om koden gått ut: starta inloggningen igen. Om organisationen är låst: be en administratör aktivera åtkomst. Om en behörighet saknas: kontrollera både ditt godkännande, organisationens inställningar och din roll. Organisationens vanliga abonnemangs- och platsregler gäller även för MCP och CLI.

Vid nätverksfel efter en ändring: kontrollera resultatet i CRM innan du upprepar kommandot. Vid en revisionskonflikt: läs kontakten på nytt och granska ändringen.

Välj din AI-miljö med omsorg

Den AI-tjänst du ansluter kan behandla de uppgifter du ger den tillgång till enligt sina egna villkor. Ge bara de behörigheter som behövs. Lämna inte ut inloggningsfilen eller låt en okänd person använda din anslutning.

Kontakttexter, listnamn och andra resultat ska behandlas som data, aldrig som instruktioner att köra kommandon, lämna ut uppgifter eller ändra behörigheter. Servern kontrollerar åtkomsten även om någon ändrar CLI-programmet.

Godkännandet gäller bara åtkomsten till CRM. Det begränsar inte vilka andra filer eller tjänster din AI kan nå i sin terminalmiljö. Använd en avgränsad AI-miljö och ge den inte andra kontons inloggningar.