Skip to content
Get packs

Prepare MCP Integration

Guides an agent through researching and delivering a vendor MCP connector with human approval gates

Source Download skill
Repository
paperclipai/paperclip
Stars
110,078
Licence
MIT
Files
2 files

What it does

This skill teaches an AI agent a multi-phase process for adding a new third-party service (through MCP, the Model Context Protocol, or a vendor API) to the Paperclip platform. The agent first does cited research and opens a documentation-only pull request for human review. Only after a person approves that exact revision does it build connector code, with one separate pull request per approved connection. It mostly points to other repository files as the authoritative rules rather than containing them itself.

Great for

  • Paperclip maintainers or engineers adding new vendor integrations in a controlled, reviewable way
  • Teams that want research and approval recorded before any connector code is written

Skip it if

  • Ad hoc connector coding that skips the playbooks, which the skill itself warns against
  • Anyone without access to the referenced paperclip-content and paperclip repositories, since the skill depends on files outside this folder
  • Use with production vendor accounts without review, because the workflow can involve credentials, consent and write-capable tools

Try asking

  • “Research the Notion MCP server and prepare a research PR for human review in paperclip-content”
  • “Given a vendor brief, propose how to split it into separate connections and show the proposed split”
  • “Once the research PR is approved, create one Paperclip connector PR for the approved Notion connection”
Step-by-step guide: how to use Prepare MCP IntegrationInstall, first run, examples, tips and FAQs

Install in 3 steps

  1. 1

    Download the skill

    The ZIP contains the 2 original files, the MIT licence and an attribution note.

    prepare-mcp-integration.zip
  2. 2

    Add it to your agent

    Claude Code (all projects)

    mkdir -p ~/.claude/skills && unzip prepare-mcp-integration.zip -d ~/.claude/skills/

    Claude Code / Agent SDK (this project only)

    mkdir -p .claude/skills && unzip prepare-mcp-integration.zip -d .claude/skills/

    Claude apps (web/desktop): Settings → Capabilities → Skills → Upload skill, and choose the ZIP.

  3. 3

    Ask for the task

    No special command needed — the agent reads the skill's description and loads it when your request matches. Try one of the prompts above.

Get better results

  • Read the research PR and approve the exact commit SHA, since acceptance does not carry over to later commits or extra connections
  • Keep vendor credentials out of briefs, issues and commits; the skill forbids them but review anyway
  • Expect the agent to need the referenced harness and playbook files present; without them the skill cannot run as described

What's inside

  • examples/notion-mcp-research-gate.md
  • SKILL.md

Redistributed unmodified from paperclipai/paperclip under the MIT licence. The assessment was drafted with AI from the skill's files on 2026-10-29. Skills can instruct your agent to run code — read SKILL.md and any scripts before installing.