Skip to main content

Claude

Install the SparkLogs plugin so Claude gets investigation skills, follow-up commands, and the SparkLogs MCP connection. Then sign in to SparkLogs in the browser when Claude prompts.

Marketplace repository: itlightning/sparklogs-ai-plugins.

Claude Code​

/plugin marketplace add itlightning/sparklogs-ai-plugins
/plugin install sparklogs@sparklogs-ai-plugins

Then run /reload-plugins (or restart Claude Code). When Claude prompts, sign in to SparkLogs in the browser.

Ask about a monitored host in plain language. Ask for sparklogs-investigate when you want a cited report. sparklogs-analyze-cause is the follow-up for candidate causes.

Claude Code namespaces command files, so the follow-ups look doubled:

/sparklogs:sparklogs-explain <finding or claim>
/sparklogs:sparklogs-summary <investigation id>

Claude Desktop​

  1. Open the Directory from the sidebar and pick Plugins.
  2. Click + (Add marketplace), choose Add from a repository, enter itlightning/sparklogs-ai-plugins, and click Sync. Leave Sync automatically on to pick up updates.
  3. Install sparklogs from the listing.
  4. When Claude prompts, sign in to SparkLogs in the browser.

Start a new conversation and ask about a monitored host. The picker lists sparklogs-explain and sparklogs-summary (Desktop has no marketplace namespace). Ask, investigate, and analyze-cause are skills: ask in plain language.

Official plugin directory

Until SparkLogs is in Anthropic's official directory, install from the custom marketplace steps above. Do not look for it under Customize → Plugins → Browse plugins.

Organization-wide deployment​

Claude Team and Enterprise plans can deploy company-wide from Organization settings. That covers Claude on the web, the Chat tab in Claude Desktop, and Cowork. Developers who use Claude Code (the terminal) still add the plugin there with the Claude Code steps above.

Skills plugin (recommended). The plugin packages investigation skills and knowledge plus the SparkLogs MCP connection. Anthropic currently requires organizations to curate their own plugin marketplace, where you add a reference to our public plugin. See Anthropic's docs to manage plugins for your organization.

How to add SparkLogs:

  • Turn on Cowork and Skills for the organization if they are not already on.
  • Create a private GitHub repository for the marketplace, or open the one you already use.
  • If this is your first plugin, save the file below as .claude-plugin/marketplace.json in that repository. Replace company-plugins and the owner fields with your organization's name and contact email.
  • If you already have a marketplace.json, copy the SparkLogs object from the plugins array below into your existing plugins array.
.claude-plugin/marketplace.json
{
  "$schema": "https://anthropic.com/claude-code/marketplace.schema.json",
  "name": "company-plugins",
  "owner": {
    "name": "Your organization",
    "email": "admin@example.com"
  },
  "plugins": [
    {
      "name": "sparklogs",
      "description": "Investigate IT and MSP client issues with SparkLogs telemetry, evidence-cited summaries, and root-cause analysis.",
      "author": {
        "name": "IT Lightning, LLC",
        "email": "help@itlightning.com"
      },
      "homepage": "https://sparklogs.com/",
      "license": "Apache-2.0",
      "repository": "https://github.com/itlightning/sparklogs-ai-plugins",
      "category": "observability",
      "source": {
        "source": "git-subdir",
        "url": "https://github.com/itlightning/sparklogs-ai-plugins.git",
        "path": "plugins/claude/sparklogs",
        "ref": "dist"
      }
    }
  ]
}
  • In Claude, go to Organization settings → Plugins, choose GitHub as the source, and connect that repository.
  • Choose how the plugin is distributed: available for members to install, installed by default, or required.
  • Each member signs in to SparkLogs when Claude prompts for the bundled connector.

To pick up a newer SparkLogs plugin later, make a commit in your marketplace repository and sync: turn Sync automatically on, or click Update. A sync fetches SparkLogs from the dist branch of our public plugin repository.

MCP only. Use this if you want SparkLogs query tools without installing the skills plugin. Do not add a custom connector if you already installed the plugin; the plugin already includes MCP.

  • Owner: Organization settings → Connectors → Add → Custom → Web.
  • Server URL: https://mcp.sparklogs.app/mcp.
  • Members: Customize → Connectors → Connect, then sign in to SparkLogs.

Anthropic: custom connectors using remote MCP.

Updating​

Claude Code​

claude plugin marketplace update sparklogs-ai-plugins
claude plugin update sparklogs

Claude Desktop​

Updates automatically when Sync automatically was left on at install.

Organization-wide​

If you installed the skills plugin from your organization's GitHub marketplace:

  • Make a commit in that marketplace repository (a small change to marketplace.json is enough).
  • In Claude, go to Organization settings → Plugins and click Update, or leave Sync automatically on so a version-bump pull request syncs when it merges.

That sync fetches the current SparkLogs package from the dist branch of our public plugin repository.

If you added only the custom MCP connector and did not install the plugin, there is no plugin to update. Tool descriptions refresh from the SparkLogs MCP server when members connect.