Gå till innehållet

Använda Colleag från dina AI-verktyg

Dina kod- och AI-verktyg, till exempel Claude Code eller Cursor, kan läsa er organisations Colleag medan du arbetar: produktdokumentationen, företagets processer, era standarder och komponentinformationen. Du frågar i editorn, och verktyget slår upp svaret i Colleag i stället för att gissa.

Kopplingen använder MCP (Model Context Protocol), den öppna standard som verktygen använder för att nå andra system. Colleag är ett sådant system: verktyget loggar in dig och anropar sedan Colleags läsverktyg åt dig.

Tanken

  • Dokumentationen där arbetet sker. Firmware, testskript, ett datablad, ett kundsvar: verktyget kan stämma av dem mot det som produktdokumentationen, standarderna och designbesluten säger.
  • Du, inte ett tjänstekonto. Verktyget loggar in som dig och läser precis det du får läsa i Colleag, på din behörighetsnivå och inom dina work roles. Tas någon bort i Colleag slutar också deras verktyg att fungera.
  • Bara läsning. AI-verktyg kan inte ändra något i Colleag i den här versionen. Skriva, publicera och godkänna gör man i Colleag.
  • Er admin bestämmer. AI tool access är avstängt tills en admin slår på det, och admin väljer vilka sorters data ett AI-verktyg får läsa. Varje anrop finns i granskningsloggen (Audit trail).

Vart svaren tar vägen

Det ett AI-verktyg läser från Colleag går vidare till verktygets egen AI-leverantör, som en del av ditt samtal med verktyget. Därför är ERP, frakt, deals och webbsökning avstängda för AI-verktyg tills en admin kryssar i dem.

Innan du börjar

  • En admin har slagit på AI tool access under Settings → AI tool access. Se Inställningar och administration.
  • Du har adressen. Den slutar på /mcp. Tills du har kopplat in ett verktyg visas den under Settings → Connected accounts, i Connected AI tools, tillsammans med kommandot för Claude Code. Admins ser den också längst ner på sidan AI tool access. Hittar du den inte, fråga er admin. Sidorna finns när er Colleag erbjuder kopplingar för AI-verktyg.
  • Ditt AI-verktyg stöder MCP-servrar på distans med inloggning. Claude Code och Cursor gör det.

Koppla in

I en terminal:

claude mcp add --transport http colleag <adressen>

Starta claude, skriv /mcp, välj colleag och sedan Authenticate. Webbläsaren öppnas. Godkänn kopplingen och logga in med ditt Colleag-konto. Tillbaka i Claude Code visar /mcp att colleag är ansluten, med sina verktyg.

Öppna Cursor Settings → MCP och lägg till en server, eller lägg till den i ~/.cursor/mcp.json:

{
  "mcpServers": {
    "colleag": { "url": "<adressen>" }
  }
}

Cursor visar servern med en Login-knapp. Klicka på den, godkänn kopplingen och logga in med ditt Colleag-konto.

Alla verktyg som kan lägga till en MCP-server på distans över HTTP med inloggning (OAuth) fungerar på samma sätt. Ge verktyget adressen och logga in med ditt Colleag-konto när webbläsaren öppnas. Er admin kan begränsa vilka verktyg som får ansluta.

För att kontrollera kopplingen ber du verktyget köra whoami mot colleag. Svaret visar din e-post, din organisation, din nivå och vilka verktyg du kan använda.

Arbetssätt

Fråga med vanliga ord och nämn produkten när det spelar roll. Några mönster som fungerar bra:

Du håller på med … Be verktyget att …
Firmware eller testkod Kontrollera pinnar, tider eller gränsvärden mot produktens hårdvarudokument innan koden skrivs, och ange dokumentet.
Granska en ändring Jämföra diffen med kraven och designbesluten för den delen av produkten, och lista det ändringen inte täcker.
Svara en kund eller leverantör Hitta aktuell revision av databladet eller deklarationen och citera de relevanta raderna.
Välja en komponent Söka och jämföra komponenter med komponentinformationen och stämma av mot BOM:en.
Arbeta efter en standard Slå upp klausulen i organisationens licensierade standarder, och den process (SOP) som gäller för den.
Sätta dig in i en okänd produkt Lista dokumenten och baselines och sammanfatta vad som ändrats sedan senaste baseline.

Verktyget läser, du bestämmer. Det som ska ändras i Colleag (ett dokument, ett beslut, en granskning) gör du i Colleag, eller ber en Colleag-kollega om i arbetsytan.

Vad verktygen kan läsa

Grupperat som admin ser det. En admin slår på och av grupper under Settings → AI tool access.

Grupp På när det slås på Vad verktyget kan göra
Product documents and search Ja Hitta produkter, lista och läsa dokument, söka, baselines, spårbarhet
Company documents Ja Gemensamma dokument, projekt, processer (SOP:er), den här manualen
Standards Ja Söka i organisationens licensierade standarder och läsa klausuler
Component intelligence Ja Sökning hos distributörer, jämförelse av komponenter, BOM-analys
Dashboards Ja Lista översiktstavlor
ERP reads Nej Artiklar, BOM:er, lager, order och leverantörer från det inkopplade affärssystemet
Shipping reads Nej Priser, spårning och landad kostnad på det inkopplade fraktkontot
Deals Nej Offertregistret
Web search Nej Colleags webbsökning och sidhämtning (kostar credits)

ERP, frakt och deals kräver också själva kopplingen under Settings → Integrations, och dina work roles måste öppna dem.

När det inte fungerar

Verktyget säger Det betyder
AI tool access is switched off for this organisation En admin har inte slagit på det, eller har slagit av det. Bara whoami svarar.
This AI tool is not among the organisation's allowed AI tools Er admin har begränsat vilka verktyg som får ansluta.
AI tool access requires at least the … permission level Er admin har höjt den lägsta nivå som får ansluta.
No organisation membership for this identity Du loggade in med ett konto som inte är medlem, eller så har du tagits bort.
No product '…' in this organisation Produkten finns inte, är inte er, eller så har er admin begränsat AI-verktyg till andra produkter.
Rate limit … retry in … s För många anrop på en minut. Vänta och försök igen.