Skip to content

Document declarative tools + MCP connectors (pending ADR-0033) - #6

Merged
schlunsen merged 5 commits into
mainfrom
docs/adr-0033-declarative-tools-mcp
Jul 9, 2026
Merged

Document declarative tools + MCP connectors (pending ADR-0033)#6
schlunsen merged 5 commits into
mainfrom
docs/adr-0033-declarative-tools-mcp

Conversation

@schlunsen

Copy link
Copy Markdown
Collaborator

Summary

  • Adds "Declarative Tools" section: named agent tools with JSON Schemas mapped to templated HTTP requests in the connector manifest (tools array) — template rules, type-preserving substitution, reserved names, namespacing
  • Adds "MCP Connectors" section: apps exposing an MCP server (protocol: mcp, mcp_path) with identity via X-Webauth-* headers, tools-only scope, and re-approval on tool-list changes
  • New connector fields (tools, protocol, mcp_path) in the fields table + checklist items
  • All new content is explicitly marked "pending ADR-0033, not yet live" so agents following the skill don't emit manifests whose features the platform currently ignores, and don't claim unshipped functionality works

Companion to the platform ADR: https://github.com/clovrlabs/n0/pull/195 (ADR-0033: user-defined connectors). The identical change is applied to the sandbox skill template in that PR; this repo is the source of truth.

Test plan

  • Docs-only — review wording and confirm "pending" markers are consistent (fields table, sections, checklist)

🤖 Generated with Claude Code

Adds "Declarative Tools" and "MCP Connectors" sections plus new
connector manifest fields (tools, protocol, mcp_path) and checklist
items, all clearly marked as pending platform implementation of
ADR-0033 (user-defined connectors) so the skill doesn't claim
unshipped features work today.

Co-Authored-By: Claude Opus 4.6 <noreply@anthropic.com>
Copilot AI review requested due to automatic review settings July 8, 2026 01:46
…-truth note

Reconciles drift: the n0 repo's mirrored template had gained short-SHA /
git-tag image pushing and release-tag deploy guidance that this repo
(the source of truth) lacked. Files are now byte-identical, with a
provenance comment directing future edits here first.

Co-Authored-By: Claude Opus 4.6 <noreply@anthropic.com>

Copilot AI left a comment

Copy link
Copy Markdown

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

Pull request overview

Updates the connector-manifest documentation to describe upcoming (ADR-0033) capabilities for declarative, schema-driven tools and MCP-backed connectors, while clearly marking them as not yet live so readers don’t assume current platform support.

Changes:

  • Document new connector manifest fields: tools, protocol, and mcp_path (all marked pending ADR-0033).
  • Add a “Declarative Tools” section with JSON Schema + templated HTTP request examples and rules.
  • Add an “MCP Connectors” section describing MCP tool exposure, identity headers, and re-approval behavior.
Comments suppressed due to low confidence (1)

SKILL.md:1408

  • In the fields table this says “streamable-HTTP endpoint”, but later the MCP section uses “streamable HTTP”. Pick one spelling/hyphenation for consistency (and to avoid implying it’s a distinct protocol name).
**This is the preferred auth type** — it's zero-config for the app and eliminates credential management entirely.

💡 Add Copilot custom instructions for smarter, more guided reviews. Learn how to get started.

Comment thread SKILL.md Outdated
@schlunsen schlunsen closed this Jul 8, 2026
@schlunsen schlunsen reopened this Jul 8, 2026
schlunsen and others added 3 commits July 8, 2026 03:51
The branch ruleset requires Lunar-Rails/security-actions'
claude-security-review workflow, but reusable workflows don't
auto-trigger — the repo needs a caller. Without this, no PR can merge.

Co-Authored-By: Claude Opus 4.6 <noreply@anthropic.com>
…streamable HTTP' spelling

Co-Authored-By: Claude Opus 4.6 <noreply@anthropic.com>
@schlunsen
schlunsen merged commit 79a0401 into main Jul 9, 2026
1 check passed
Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment

Labels

None yet

Projects

None yet

Development

Successfully merging this pull request may close these issues.

2 participants