Skip to content

MCP-server för AI-agenter

HIT har en MCP-server (Model Context Protocol) som låter valfri MCP-kompatibel AI-agent — t.ex. Claude Code, Cursor eller OpenCode — läsa från din HIT-instans. Agenten kan då svara på frågor om dina ärenden med riktig data istället för att gissa.

Den körs som ett litet fristående program som du installerar via npm, och den kopplas upp med din personliga API-nyckel.

Vad den kan

Servern är skrivskyddad — den kan läsa, men aldrig skapa, ändra eller ta bort något. Den exponerar fyra verktyg:

  • list_queues — lista de köer du har åtkomst till.
  • list_tickets — bläddra och sök bland ärenden i en kö, filtrera på öppna/stängda och paginera.
  • get_ticket — hämta alla detaljer för ett enskilt ärende (beskrivning, prioritet, förfallodatum, historik).
  • list_templates — lista ärendemallar för en kö.

Komma igång

  1. Skapa en API-nyckel med åtkomsten Läs — det räcker, eftersom servern bara läser.
  2. Installera paketet globalt: npm install --global @devpeak/hit-mcp. Det installerar kommandot hit-mcp på din PATH.
  3. Peka ut din instans och nyckel via miljövariablerna HIT_BASE_URL och HIT_API_TOKEN i din AI-agents MCP-konfiguration, till exempel:
json
{
    "mcpServers": {
        "hit": {
            "command": "hit-mcp",
            "env": {
                "HIT_BASE_URL": "https://din-hit-instans",
                "HIT_API_TOKEN": "din-api-nyckel"
            }
        }
    }
}

Fullständiga installationsinstruktioner, inklusive konfiguration för Cursor och OpenCode, finns i källkodsrepot: github.com/DevpeakAB/hit-mcp.

Bra att veta

  • Servern kommer bara åt det din API-nyckel har behörighet till — den ser samma köer och ärenden som du själv.
  • Eftersom den är skrivskyddad kan den inte råka ändra något i HIT; den är säker att koppla in i en AI-agent för att sammanfatta, söka och analysera ärenden.