docs: enable Kapa WebMCP

[dannyneira]

Summary

• Enable Kapa WebMCP across the docs site so supported visiting agents can call the read-only search_warp_knowledge_sources tool.
• Load Kapa's official Website Widget script only when the dedicated PUBLIC_KAPA_WEBSITE_WIDGET_INTEGRATION_ID is configured, keeping it separate from the custom React chat integration ID.
• Hide Kapa's default floating button so Warp's existing custom React Ask AI experience remains the only human-facing chat entry point.
• Add focused tests for conditional script emission and the required WebMCP attributes.

This follows Kapa's WebMCP launch guidance. Unsupported browsers ignore the WebMCP attribute and continue using the docs normally.

Related issues

None; source context: Kapa now supports WebMCP.

Validation

• npm run test:kapa-webmcp - passed, 2/2 tests
• npm run test:heading-vars - passed, 5/5 tests
• npm run typecheck with the Website Widget integration ID - passed with 0 errors
• npm run build with the Website Widget integration ID - passed
• npm run test:homepage-json-ld - passed
• npm run test:heading-tocs - passed, 3,381 TOC entries across 397 HTML files
• Trunk checks on all touched files - passed
• Generated HTML contains exactly one Kapa widget script with the configured Website Widget ID, data-webmcp-enabled="true", and data-button-hide="true"

Screenshots

Not applicable; this intentionally adds no visual UI and preserves the existing custom Ask AI entry points.

Follow-ups

• Runtime tool registration depends on WebMCP-capable browsers and agents. Unsupported browsers ignore the attribute.
• Kapa WebMCP calls retain Kapa's existing captcha behavior and analytics.
• Vercel now provides the existing Docs Widget Website Widget integration ID to production, preview, and development builds; no new Kapa integration is required.

Co-Authored-By: Warp agent@warp.dev

Warp artifacts

• Implementation conversation

[vercel]

The latest updates on your projects. Learn more about Vercel for GitHub.

Project	Deployment	Actions	Updated
docs	Ready	Preview	Oct 20, 2026 4:50pm UTC

[warp-for-oss]

@dannyneira

I'm starting a first review of this pull request.

You can view the conversation on Warp.

I completed the review and no human review was requested for this pull request.

Comment /warp-agent-review on this pull request to retrigger a review (up to 3 times on the same pull request).

Powered by Oz

[warp-for-oss]

Overview

This PR adds a Kapa WebMCP loader to the docs head, centralizes the widget attributes, documents the public env behavior, and adds focused tests for conditional emission and attribute values.

Concerns

• No blocking concerns found in the changed files.
• Security pass: no diff-tied security findings; the new script origin is already allowed by the existing CSP, and the integration ID remains public configuration.
• Spec alignment: no approved or repository spec context was provided, so no spec-drift review was applicable.

Verdict

Found: 0 critical, 0 important, 0 suggestions

Approve

Comment /warp-agent-review on this pull request to retrigger a review (up to 3 times on the same pull request).

Powered by Oz

[dannyneira]

thanks @hongyi-chen! confirmed the new WebMCP protocol is enabled and working on the docs site. Agents can now search the docs autonomously.