Innan du börjar: kontrollera att AlmRecorder har Settings → MCP. Om den delen saknas installerar du en version med MCP-stöd.
Låt din agent göra installationen
Kopiera hela uppdraget, klistra in det i agenten och lägg AlmRecorders kopierade konfiguration längst ned. Hemlig token följer bara med när du själv klistrar in den.
Förhandsgranska instruktionerna
Konfigurera AlmRecorder som en lokal MCP-server för GitHub Copilot CLI på denna Mac.
Arbeta försiktigt och gör installationen åt mig om du har fil- och terminalåtkomst. Om du inte kan redigera lokala filer ska du i stället ge mig den exakta färdiga filändringen och säga var den ska klistras in.
1. Kontrollera först att AlmRecorder visar Settings → MCP, att appen ligger på sin slutliga plats och är öppen.
2. Be mig aktivera Enable local MCP server, vänta på Listening on … och välja Copy configuration.
3. Jag klistrar in den kopierade JSON-konfigurationen längst ned i detta uppdrag. Be mig om den om den saknas.
4. Behandla ALMRECORDER_MCP_TOKEN som ett lösenord. Skriv aldrig ut den igen, logga den inte och lägg den inte i Git, ett supportärende eller en delad projektfil.
5. Slå ihop almrecorder under mcpServers i ~/.copilot/mcp-config.json med type local, command, tom args-lista, de två env-värdena och tools: ["*"]. VS Code använder ett annat servers-format och GitHubs molnagent kan inte nå denna lokala Mac-socket.
6. Använd exakt command, ALMRECORDER_MCP_SOCKET och ALMRECORDER_MCP_TOKEN från AlmRecorder. Transporten är lokal stdio och AlmRecorderMCPBridge har inga argument.
7. Ändra eller radera inga andra klientinställningar. Visa en diff eller beskriv exakt vad som ändrades.
8. Kör copilot mcp list och starta sedan en lokal Copilot CLI-session.
9. Be agenten anropa get_library_status och rapportera antalet inspelningar. Anropa sedan list_recordings med limit: 1. Ändra ingenting.
10. Aktivera inte AlmRecorders innehålls- eller skrivbehörigheter. Jag väljer dem själv efter att den skrivskyddade kontrollen fungerar.
ALMRECORDERS KOPIERADE KONFIGURATION:
[Klistra in Copy configuration från AlmRecorder här]Välj den Copilot som körs på denna Mac
AlmRecorder är en lokal stdio-server som använder en Unix-socket på denna Mac. Det skapar en tydlig kompatibilitetsgräns:
- GitHub Copilot CLI: stöds när CLI:n och AlmRecorder körs på samma Mac. Följ den här sidan.
- GitHub Copilot Chat i VS Code: stöds genom VS Codes användarprofil för
mcp.json. Använd VS Code-guiden. - Copilot coding agent på GitHub.com: stöds inte. Molnagenten körs i GitHubs infrastruktur och kan varken nå AlmRecorders lokala socket eller starta bryggan inuti Mac-appen.
Copilot CLI och VS Code läser inte samma MCP-fil. Copilot CLI använder ~/.copilot/mcp-config.json; VS Code använder en egen mcp.json med objektet servers.
Installera och förbered
Installera GitHub Copilot CLI med Homebrew:
brew install copilot-cli
Eller använd npm med Node.js 22 eller senare:
npm install -g @github/copilot
Kör copilot, skriv /login och slutför GitHub-inloggningen. Om Copilot kommer via en organisation måste administratören tillåta Copilot CLI.
Förbered sedan AlmRecorder:
- Låt AlmRecorder.app ligga i Program och håll appen öppen.
- Stäng av Allow MCP clients to access this recording på allt känsligt. Använd Hide from MCP för privata taggar.
- Låt innehålls- och ändringsbehörigheterna vara avstängda under Settings → MCP. Aktivera den lokala servern och vänta på Listening on ….
- Välj Copy configuration.
Token kopieras — den visas inte
AlmRecorder döljer avsiktligt den riktiga token i förhandsvisningen. Du ska alltså inte leta efter ett synligt tokenfält.
- Öppna Settings → MCP i AlmRecorder.
- Aktivera Enable local MCP server och vänta tills Status visar Listening on ….
- Välj Copy configuration. Urklippet innehåller nu kommando, socket och den riktiga ALMRECORDER_MCP_TOKEN.
Klistra konfigurationen direkt där guiden anger. Behandla den som ett lösenord och rensa urklippet när anslutningen fungerar.
Välj Copy configurationBehörighetsgräns: AlmRecorder avgör vilka inspelningar och fält som finns för varje klient. Copilots egna verktygskontroller lägger till ett lager, men kan aldrig åsidosätta ett nekande i AlmRecorder.
Lägg till i Copilot CLI
Öppna eller skapa ~/.copilot/mcp-config.json. Slå ihop posten almrecorder nedan—ersätt inte befintliga servrar:
{
"mcpServers": {
"almrecorder": {
"type": "local",
"command": "/Applications/AlmRecorder.app/Contents/MacOS/AlmRecorderMCPBridge",
"args": [],
"env": {
"ALMRECORDER_MCP_SOCKET": "/Users/du/Library/Application Support/AlmRecorder/MCP/mcp.sock",
"ALMRECORDER_MCP_TOKEN": "klistra in token som kopierades från AlmRecorder"
},
"tools": ["*"]
}
}
}
Använd exakt command, socket och token från Copy configuration. Token ligger i klartext i denna privata användarfil. Lägg den inte i .mcp.json, .github/mcp.json, Git, ett supportärende eller en delad prompt.
Kontrollera registreringen:
copilot mcp list
copilot mcp get almrecorder
I en lokal Copilot CLI-session visar /mcp show almrecorder status och verktyg.
Kontrollera anslutningen
Be Copilot:
Use AlmRecorder’s
get_library_statustool and report the recording count. Then calllist_recordingswithlimit: 1. Do not change anything.
Det första anropet bekräftar att Copilot nådde den öppna AlmRecorder-appen. Aktivera först därefter transkriptinnehåll eller ändringar i AlmRecorder om du behöver dem.
Om det inte fungerar
copilotsaknas: installera CLI:n och logga sedan in med/login.- Servern saknas: validera
~/.copilot/mcp-config.json; Copilot CLI läser inte.vscode/mcp.json. - Servern blockeras: organisationens MCP-lista eller policy för Copilot CLI kan kräva administratörens godkännande.
- Verktygen syns men anrop misslyckas: håll AlmRecorder öppet, aktivera servern och kopiera nya socket/token-värden.
- Det fungerar i VS Code men inte i CLI:n: konfigurera båda separat; deras MCP-format och filer skiljer sig.
Kör copilot mcp remove almrecorder för att koppla från Copilot CLI. Stäng av servern eller rotera AlmRecorders token för att återkalla alla kopierade klientkonfigurationer.
Installera GitHub Copilot CLI · GitHubs MCP-guide för Copilot CLI · Integritet i AlmRecorder

