К основному содержанию
скилл CX Codex

harper-mcp — скилл для Claude Code: настройка и установка

Скилл для Claude Code помогает подключать MCP-клиенты к Harper и настраивать доступ к данным и функциям. Включается при работе с MCP-сервером Harper, его инструментами, ресурсами и безопасностью.

Apache-2.0 114 установок ★ 3 обновлён 2026-10-24

Установить в Claude Code · Через Skills CLI (Vercel) Все способы и платформы ↓
npx skills add HarperFast/skills --skill harper-mcp -a claude-code
Открыть на GitHub

Что делает harper-mcp

Скилл объясняет, как включить MCP-сервер Harper и подключить к нему клиент: описывает handshake, заголовки сессии и версии протокола, а также аутентификацию. Отдельно разбирает автоматические CRUD-инструменты для экспортированных таблиц и пользовательские инструменты, промпты и ресурсы.

В руководстве есть настройки ограничения частоты запросов, долговременных квот и защиты публичных MCP-точек. Профили application и operations независимы: первый задаёт интерфейс приложения, второй — административные операции Harper. Для примеров и подробных правил в репозитории есть файлы в rules/ и сборный документ AGENTS.md.

Какие задачи решает

  • включить MCP-профиль на экземпляре Harper
  • подключить MCP-клиент с нужными заголовками и аутентификацией
  • настроить автоматические CRUD-инструменты для таблиц
  • опубликовать пользовательские инструменты, промпты или ресурсы
  • ограничить запросы и защитить публичную MCP-точку

Примеры запросов агенту

  • Настрой MCP-сервер Harper и подключение MCP-клиента.
  • Покажи, какие автоматические CRUD-инструменты доступны для таблиц Harper.
  • Как ограничить вызовы MCP-инструментов и защитить публичную точку Harper?

Как установить harper-mcp

1Через Skills CLI (Vercel)

npx skills add HarperFast/skills --skill harper-mcp -a claude-code

2Вручную: положить файлы

~/.claude/skills/harper-mcp/SKILL.md

Папка скилла целиком; для одного проекта — .claude/skills/harper-mcp/

По шагам, с командами для каждой платформы: Как установить скилл в Claude Code: пять способов

Вопросы о harper-mcp

Как установить harper-mcp в Claude Code?

Выполни npx skills add HarperFast/skills --skill harper-mcp -a claude-code. Файл скилла находится по пути ~/.claude/skills/harper-mcp/SKILL.md.

Что делает harper-mcp?

Скилл описывает настройку MCP-сервера Harper и подключение клиентов, а также публикацию инструментов, промптов и ресурсов. В нём есть разделы об ограничении запросов и безопасности.

Какие профили MCP поддерживает Harper?

Два независимых профиля: application для интерфейса приложения и operations для административных операций Harper.

Исходный текст

SKILL.md · Apache-2.0
---
name: harper-mcp
description: Comprehensive guide to Harper's Model Context Protocol (MCP) interface,
  covering server setup, client connection, automatic and custom tools, prompts,
  resources, rate limiting, durable quotas, and the security model.
  Triggers on tasks involving MCP servers on Harper, AI-client integration,
  and exposing Harper data or behavior to LLM agents.
license: Apache-2.0
metadata:
  author: harper
  version: '1.0.0'
---

# Harper MCP

Guidelines for exposing a Harper instance as a Model Context Protocol (MCP) server and for building the tools, prompts, and resources AI clients consume. Harper implements MCP Streamable HTTP (spec rev 2025-06-18) with two independent profiles: `application` (your app's surface) and `operations` (Harper administration).

## When to Use

Reference these guidelines when:

- Enabling or configuring the MCP endpoint on a Harper instance
- Connecting an MCP client (Claude, agent frameworks, custom HTTP code) to Harper
- Deciding what tools an AI should see for a schema, or trimming that surface
- Exposing custom behavior (`mcpTools`), prompt templates (`mcpPrompts`), or content (`mcpResources`) to AI clients
- Protecting a public or anonymous-accessible MCP endpoint (rate limits, durable quotas, hardening)
- Debugging MCP wire errors (session/protocol headers, 400s, SSE)

## How It Works

1. Start with `enabling-mcp` to mount a profile, then `connecting-clients` for the handshake contract.
2. For the tool surface, consult `automatic-verb-tools` first — most CRUD needs are covered with zero code — and reach for `custom-mcp-tools` only for real behavior.
3. For content and templates, use `custom-mcp-resources` and `custom-mcp-prompts`; `resources-surface` explains what exists without any code.
4. Before any public exposure, work through `security-posture`'s checklist and configure `rate-limiting` (+ `durable-quotas` for cost-bearing tools).

## Examples

See the concrete examples embedded in each rule (curl handshakes, `static mcpTools`/`mcpResources` declarations, quota-hook implementations, and hardening configs).

<!-- BEGIN GENERATED INDEX -->

## Rule Categories by Priority

| Priority | Category              | Impact | Prefix       |
| -------- | --------------------- | ------ | ------------ |
| 1        | Setup & Connection    | HIGH   | `setup-`     |
| 2        | Tools & Prompts       | HIGH   | `tools-`     |
| 3        | Resources             | MEDIUM | `resources-` |
| 4        | Operations & Security | HIGH   | `ops-`       |

## Quick Reference

### 1. Setup & Connection (HIGH)

- `enabling-mcp` — How to enable and configure Harper's MCP server profiles (application and operations).
- `connecting-clients` — How MCP clients connect to Harper - the initialize handshake, session and protocol-version headers, and authentication.

### 2. Tools & Prompts (HIGH)

- `automatic-verb-tools` — How Harper auto-generates CRUD MCP tools from exported tables, with RBAC filtering and allow/deny/maxTools controls.
- `custom-mcp-tools` — How to expose custom instance methods as MCP tools via static mcpTools, including the anonymous-exposure security model.
- `custom-mcp-prompts` — How to publish reusable prompt templates to MCP clients via static mcpPrompts.

### 3. Resources (MEDIUM)

- `resources-surface` — The MCP resources surface - harper:// metadata URIs, harper+rest:// table descriptors, templates, subscriptions, and list_changed notifications.
- `custom-mcp-resources` — How to serve custom content (docs pages, reports, binaries) as MCP resources via static mcpResources with URI templates and completions.

### 4. Operations & Security (HIGH)

- `rate-limiting` — MCP tools/call rate limiting - per-tool, per-session, and per-client-identity token buckets, and the identityHeader trust model.
- `durable-quotas` — Operator-pluggable durable quotas for MCP tools/call via the server.setMcpQuotaHandler registration hook, with a race-safe counter pattern.
- `security-posture` — The MCP security model - anonymous access, RBAC boundaries, origin validation, audit logging, and the hardening checklist for public instances.

<!-- END GENERATED INDEX -->

## How to Use

Read individual rule files for detailed explanations and code examples:

```
rules/enabling-mcp.md
rules/connecting-clients.md
rules/custom-mcp-tools.md
rules/custom-mcp-resources.md
rules/security-posture.md
```

## Full Compiled Document

For the complete guide with all rules expanded: `AGENTS.md`

© harper · Apache-2.0 · HarperFast/skills

Похожие скиллы

Все скиллы по теме «Бэкенд и API» →
extension-http-outcalls caffeinelabs Скилл extension-http-outcalls для Claude Code отправляет HTTP-запросы из backend canister во внешние API. Он проверяет локальный curl и требует серверного ограничения ответа. CX Codex +1 32 200установок oauth2-provider-design Samuel Berthe Скилл oauth2-provider-design помогает спроектировать собственный сервер авторизации OAuth 2.1 в B2B SaaS. Полезен при настройке входа через сервис, выдаче токенов сторонним приложениям и проверке прав. CX Codex +1 10 500установок api-test-mode-design Samuel Berthe Скилл api-test-mode-design для Claude Code проектирует тестовый режим публичного API. Он включается при запросах о песочнице, тестовых ключах, демо-данных или имитации событий вебхука. CX Codex +1 10 400установок owasp-security hoodini Скилл owasp-security для Claude Code закрывает дыры из OWASP Top 10: доступ, инъекции, криптография, конфиги. Покрывает написание авторизации и правку API. CX Codex +1 3 100установок base44-platform-connectors base44 Скилл base44-platform-connectors для Claude Code и Cursor настраивает OAuth-интеграции с внешними сервисами Google, Slack и GitHub. Задействуется, когда приложению требуется действовать от аккаунта пользователя или разработчика. CX Codex +1 3 000установок sender-profile-architect sentdm Скилл sender-profile-architect помогает спроектировать архитектуру профилей отправителя в Sent v3 для мультиарендных систем. Пригодится при настройке биллинга, номеров WABA и 10DLC. CX Codex +1 2 900установок

Из того же набора2

Спонсоры проекта

Компании, которые помогают держать аналитику открытой