Servidor MCP JupiterOne

Un servidor Model Context Protocol (MCP) que proporciona accés a les eines de JupiterOne. Aquest servidor permet als assistents IA i altres clients MCP interactuar amb les dades de JupiterOne.

Configuració

Requisits previs

1. Compte JupiterOne: Necessites un compte JupiterOne actiu
2. Clau API: Genera una clau API des de la configuració del teu compte JupiterOne
3. Identificador de compte: L'identificador del teu compte JupiterOne
4. Instal·lació de Node.js funcional amb versió >= 18 (Veure https://nodejs.org/en/download i clicar un dels botons verds)

Instal·lació amb Claude Desktop

Per utilitzar aquest servidor MCP amb Claude Desktop, has d'afegir-lo al fitxer de configuració de Claude.

Opció 1: Utilitzant npx (Recomanat)

Afegeix la següent configuració al fitxer de configuració de Claude Desktop:

{
  "mcpServers": {
    "jupiterone": {
      "command": "npx",
      "args": ["-y", "@jupiterone/jupiterone-mcp"],
      "env": {
        "JUPITERONE_API_KEY": "your-api-key-here",
        "JUPITERONE_ACCOUNT_ID": "your-account-id-here",
        "JUPITERONE_BASE_URL": "https://graphql.us.jupiterone.io"
      }
    }
  }
}

Opció 2: Instal·lació global (Per a usuaris nvm o resolució de problemes)

Si utilitzes nvm o tens problemes amb l'Opci 1, primer instal·la el paquet globalment:

npm install -g @jupiterone/jupiterone-mcp

Afegeix aquesta configuració al fitxer de configuració de Claude Desktop:

{
  "mcpServers": {
    "jupiterone": {
      "command": "/usr/local/bin/node",
      "args": ["/usr/local/bin/jupiterone-mcp"],
      "env": {
        "JUPITERONE_API_KEY": "your-api-key-here",
        "JUPITERONE_ACCOUNT_ID": "your-account-id-here",
        "JUPITERONE_BASE_URL": "https://graphql.us.jupiterone.io"
      }
    }
  }
}

Nota: Pot ser necessari ajustar els camins en l'Opci 2 segons la instal·lació de Node.js:

• Per a Node.js de Homebrew: /usr/local/bin/node i /usr/local/bin/jupiterone-mcp
• Per a nvm: ~/.nvm/versions/node/v[version]/bin/node i ~/.nvm/versions/node/v[version]/bin/jupiterone-mcp

Instal·lació amb Cursor

Per a Cursor IDE, afegeix la mateixa configuració a les teves preferències de Cursor:

1. Obre la Configuració de Cursor
2. Ves a "Features" → "Model Context Protocol"
3. Afegeix la configuració del servidor utilitzant l'Opció 1 o l'Opció 2 d'aquí amunt

Variables d'entorn

Substitueix els valors de marcador de posició amb les teves credencials reals de JupiterOne:

• JUPITERONE_API_KEY: La teva clau API de JupiterOne (obligatòria)
• JUPITERONE_ACCOUNT_ID: L'identificador del teu compte JupiterOne (obligatòria).
• JUPITERONE_BASE_URL: Punt final GraphQL de JupiterOne (opcional, per defecte a https://graphql.us.jupiterone.io)

Obtenció de les teves credencials de JupiterOne

1. Clau API:

   • Inicia sessió al teu compte JupiterOne
   • Ves a Settings → API Keys
   • Crea una nova clau API o utilitza una existent

2. Identificador de compte:

   • Es pot recuperar d'una de les dues maneres següents:
   • Navegant a https://j1dev.apps.us.jupiterone.io/settings/account-management
   • Executa la següent consulta al teu compte JupiterOne: find jupiterone_account as x return x.accountId

Funcionalitats

Gestió de regles

• list-rules - Llista totes les regles del compte amb un paràmetre limit opcional
• get-rule-details - Obtén informació detallada d'una regla específica per ID
• create-inline-question-rule - Crea noves regles basades en preguntes amb operacions i accions
• update-inline-question-rule - Actualitza instàncies de regles de pregunta en línia existents
• evaluate-rule - Triggira una avaluació a demanda d'una regla específica