ChannelCRM MCP Server

Kræver ChatGPT Plus, Pro, Business, Enterprise eller Edu. Custom connectors virker ikke på den gratis version af ChatGPT.

1. Gå til indstillinger for arbejdsområdet

Åbn Settings for dit arbejdsområde og gå til Apps. Opret en ny app.

2. Udfyld app-detaljer

Name	ChannelCRM
Description	Forbindelse til ChannelCRM
MCP Server URL	`https://mcpserver.channelcrm.dk`
Authentication	OAuth

3. Log ind

ChatGPT vil åbne en login-dialog hvor du logger ind med din ChannelCRM e-mail og tenant navn.

1. Åbn Connectors-indstillingerne

Klik på din konto nederst i venstre hjørne → Settings → Customize → Connectors.

2. Tilføj en custom connector

Klik på Add (+) øverst til højre og vælg Add custom connector.

3. Udfyld navn og server-URL

Name	ChannelCRM
Remote MCP Server URL	`https://mcpserver.channelcrm.dk/mcp`

4. Tilføj og forbind

Klik Add, og klik derefter Connect for at forbinde til connectoren.

5. Log ind

Claude åbner login-siden. Log ind med din ChannelCRM-konto, og udfyld tenantnavnet for den tenant du vil have adgang til.

Sådan connecter du et Lovable projekt til ChannelCRM

Forbindelsen bruger OAuth 2.1 med PKCE til autentificering, og alle MCP-kald kører server-side så tokens aldrig eksponeres i browseren.

Forudsætninger

Et Lovable-projekt baseret på TanStack Start (fuldstack React med server functions via createServerFn)
En SESSION_SECRET miljøvariabel til kryptering af cookies

Trin 1: OAuth 2.1 + PKCE-login

1.1 Login-initiering (/auth/login)

Når brugeren klikker "Forbind til ChannelCRM":

Generér code_verifier + code_challenge (S256) og en state-værdi.
Gem code_verifier og state i en kortlivet, krypteret cookie.
Redirect til authorization-endpointet med følgende parametre:

https://mcpserver.channelcrm.dk/authorize?
  response_type=code
  &client_id=<din_client_id>
  &redirect_uri=https://<host>/auth/callback
  &code_challenge=<code_challenge>
  &code_challenge_method=S256
  &state=<state>

Vigtigt: Host-navnet (redirect_uri) skal udledes fra x-forwarded-host så det virker både i Lovable-preview og produktion. Brug et popup-vindue (target="_blank") til login for at undgå CSP-begrænsninger.

1.2 Callback (/auth/callback)

Verificér state mod cookien.
POST til token-endpointet:

POST https://mcpserver.channelcrm.dk/token

grant_type=authorization_code
&code=<modtaget_kode>
&redirect_uri=<samme_som_ovenfor>
&client_id=<din_client_id>
&code_verifier=<fra_cookie>

Modtaget access_token har 12 timers levetid. Der returneres pt. intet refresh_token.
Gem access_token i en krypteret session-cookie med flags: SameSite=None, Secure, HttpOnly.
Popup-vinduet sender postMessage til window.opener og lukker sig selv.

Trin 2: MCP-forbindelse

2.1 Endpoint og transport

https://mcpserver.channelcrm.dk/mcp

Transport: Streamable HTTP (JSON-RPC 2.0 over HTTPS POST)

2.2 Påkrævede headers

Authorization: Bearer <access_token>
Content-Type: application/json
Accept: application/json, text/event-stream
Mcp-Session-Id: <id_fra_initialize-svaret,_hvis_sat>

Bemærk: Accept-headeren skal indeholde både application/json og text/event-stream — ellers returneres 406 Not Acceptable.

2.3 MCP-klient flow (server-side via createServerFn)

initialize — Første kald; gem Mcp-Session-Id fra svaret og genbrug det på efterfølgende kald
tools/list — Opdag tilgængelige værktøjer (gerne cachet pr. session)
tools/call — Kald det ønskede værktøj

Ved 401: invalider sessionen, forsøg token-refresh, retry kaldet én gang.

Trin 3: Sikkerhed

Element	Håndtering
`code_verifier`	Krypteret cookie, server-side
`state`	Krypteret cookie, server-side
`access_token`	Krypteret cookie (`SESSION_SECRET`)
Cookie flags	`HttpOnly`, `Secure`, `SameSite=None`
Token eksponering	Aldrig til klienten
`redirect_uri`	Udledes fra `x-forwarded-host` pr. request

1. Åbn Microsoft Copilot Studio og gå til dit Copilot-projekt

Vælg Tools → Add a tool → Tilføj Model Context Protocol-server.

2. Udfyld MCP server oplysninger

URL-adresse til server	`https://mcpserver.channelcrm.dk/mcp`
Godkendelse	OAuth 2.0
Type	Dynamisk opdagelse

3. Log ind

Copilot Studio åbner en login-dialog hvor du logger ind med din ChannelCRM e-mail og tenant navn.

Custom MCP-connectors oprettes ikke inde i selve Mistral Vibe — de konfigureres via Mistral Studio.

1. Åbn Mistral Studio og gå til Connectors

Gå til console.mistral.ai og find Connectors. Klik på + Add Connector og skift til fanen Custom MCP Connector.

2. Udfyld connector-oplysninger

Connector name	ChannelCRM
Server URL	`https://mcpserver.channelcrm.dk/mcp`
Description	Forbindelse til ChannelCRM (valgfri)

3. Forbind og log ind

Klik Connect. Mistral Studio opdager automatisk at serveren bruger OAuth og åbner en login-dialog, hvor du logger ind med din ChannelCRM e-mail og tenant navn.

4. Brug connectoren i Mistral Vibe

Når connectoren er oprettet i Mistral Studio, kan den aktiveres og bruges i Mistral Vibe (chat.mistral.ai) under samtaler.