# `vpa360-import` skill — install guide

Self-contained Claude skill that teaches Claude Web / Claude Excel /
Claude Code how to drive the VPA360 Import Tool's MCP server.

You are reading this from **https://data-extractor.vpa-360.com** — substitute that host into the
snippets below. Sharing this URL with another user gets them everything
they need to install.

## What's here

| File | Purpose |
|---|---|
| [`SKILL.md`](https://data-extractor.vpa-360.com/skill/SKILL.md) | The skill itself. Frontmatter (`name`, `description`) plus instructions for the LLM on when/how to use the MCP tools. Connection-agnostic. |
| [`README.md`](https://data-extractor.vpa-360.com/skill/README.md) | This file — install instructions for *this specific* deployment. |

## Endpoints for this deployment

```
Web UI:        https://data-extractor.vpa-360.com/
MCP SSE:       https://data-extractor.vpa-360.com/mcp/sse
MCP messages:  https://data-extractor.vpa-360.com/mcp/messages/
```

Auth on every MCP request:

```
Authorization: Bearer <your-token>
```

## Install

### Claude Code (per-user)

```sh
mkdir -p ~/.claude/skills/vpa360-import
curl -k -o ~/.claude/skills/vpa360-import/SKILL.md \
  https://data-extractor.vpa-360.com/skill/SKILL.md
```

Then add the MCP server to your Claude Code MCP config (e.g.
`~/.claude.json` or `claude mcp add`):

```json
{
  "mcpServers": {
    "vpa360-import": {
      "type": "sse",
      "url": "https://data-extractor.vpa-360.com/mcp/sse",
      "headers": { "Authorization": "Bearer <your-token>" }
    }
  }
}
```

### Claude Code (project-scoped)

Drop the file at `.claude/skills/vpa360-import/SKILL.md` inside any project
where you want it active. Add the same MCP server entry to that project's
`.mcp.json`.

### Claude Web / Claude Desktop

1. Add the MCP server in **Settings → Connectors → Add custom integration**.
   - Name: `VPA360 Import`
   - Type: `MCP server (SSE)`
   - URL: `https://data-extractor.vpa-360.com/mcp/sse`
   - Header: `Authorization: Bearer <your-token>`
2. Share `SKILL.md` with the assistant by uploading it as a project file or
   pasting its contents into the project's instructions panel.

### Claude for Excel

The Excel add-in talks to the same MCP server. Connect it via the same URL
+ Bearer header in the add-in's settings. The skill file is loaded the same
way as for Claude Web.

## Notes

- This deployment uses a self-signed TLS certificate. Browsers will warn the
  first time you visit; accept the warning, or import the CA into your trust
  store. Playwright / curl `-k` already bypass it.
- The `SKILL.md` file is host-agnostic and won't change between
  deployments. Only this README rewrites itself with the deployment URL.

## Updating

Re-fetch the files from `https://data-extractor.vpa-360.com/skill/` when the tool surface changes.
The MCP server's `list_tools` response is also self-describing — agents
that don't load the skill file will still get enough metadata to drive the
three tools correctly.