Skip to content

Application connections tech preview (A.K.A. MCP OAuth)#7104

Open
shainaraskas wants to merge 6 commits into
mainfrom
mw-oauth
Open

Application connections tech preview (A.K.A. MCP OAuth)#7104
shainaraskas wants to merge 6 commits into
mainfrom
mw-oauth

Conversation

@shainaraskas

@shainaraskas shainaraskas commented Jun 24, 2026

Copy link
Copy Markdown
Member

What this adds

Docs for connecting MCP hosts to the agent builder MCP server with OAuth, alongside the existing API key method.

New pages:

Also: split API key setup into its own MCP server API keys page and trimmed MCP server to an overview plus an auth method comparison. Minor crosslink, terminology, and permissions updates.

How it's organized, and why

  • Setup and concepts live under Application connections in Deploy & Manage, since app connections are a Cloud/org concept and the org-level view is in the Cloud Console. This will allow the concepts to be easily expanded upon when we roll out support for CLI OAuth etc.
  • The MCP server itself and the OAuth vs. API keys comparison stay in Agent Builder docs, where the feature lives. I'll also be crosslinking the OAuth page below the mcp server page in agent builder, but can't do that until after this merges due to tooling limitations
  • One overview page on top, task pages (create, connect, revoke) beneath it.

Open questions

  • Read-only or read-write tools in preview? PRD says read-only ES|QL; QA showed write tools. Affects the OAuth and MCP server pages.
  • Retention windows for revoked connections (3 months?) and clients (1 year?) — unconfirmed.
  • Is Cursor supported in preview? (cp-iam-team#2974)
  • Programmatic client creation API endpoint link, once public. (cp-iam-team#2429)
  • "Connected by" for removed org members — shows email, falls back to user ID; former-member behavior unconfirmed. (kibana#98260, cp-iam-team#2933)

Generative AI disclosure

  1. Did you use a generative AI (GenAI) tool to assist in creating this contribution?
  • Yes
  • No
  1. If you answered "Yes" to the previous question, please specify the tool(s) and model(s) used (e.g., Google Gemini, OpenAI ChatGPT-4, etc.).

Tool(s) and model(s) used: opus 4.8 plus a lot of elbow grease

@github-actions

github-actions Bot commented Jun 24, 2026

Copy link
Copy Markdown
Contributor

Elastic Docs Style Checker (Vale)

Summary: 2 warnings, 2 suggestions found

⚠️ Warnings (2): Fix when the suggestion improves clarity or correctness.
File Line Rule Message
deploy-manage/app-connections/oauth-clients.md 58 Elastic.Spelling 'revalidated' is a possible misspelling.
explore-analyze/ai-features/agent-builder/mcp-server-api-keys.md 73 Elastic.Latinisms Latin terms and abbreviations are a common source of confusion. Use 'versus' instead of 'VS'.
💡 Suggestions (2): Optional style improvements. Apply when helpful.
File Line Rule Message
deploy-manage/app-connections/oauth-clients.md 64 Elastic.Semicolons Use semicolons judiciously.
explore-analyze/ai-features/agent-builder/mcp-server-api-keys.md 34 Elastic.WordChoice Consider using 'run, start' instead of 'execute', unless the term is in the UI.

The Vale linter checks documentation changes against the Elastic Docs style guide. To use Vale locally or report issues, refer to Elastic style guide for Vale.

@github-actions

Copy link
Copy Markdown
Contributor

Elastic Docs AI PR menu

Check the box to run an AI review for this pull request.

  • Review docs changes (docs-review). Status: not started.

Powered by GitHub Agentic Workflows and docs-actions. For more information, reach out to the docs team.

@shainaraskas shainaraskas changed the title stand up marci mcp docs Application connections tech preview Jul 2, 2026
@shainaraskas

Copy link
Copy Markdown
Member Author

todo: disambiguation note on elasticsearch://reference/search-connectors/index.md

@shainaraskas shainaraskas marked this pull request as ready for review July 3, 2026 22:40
@shainaraskas shainaraskas requested review from a team as code owners July 3, 2026 22:40
@shainaraskas shainaraskas changed the title Application connections tech preview Application connections tech preview (A.K.A. MCP OAuth) Jul 3, 2026
@shainaraskas shainaraskas requested a review from leemthompo July 3, 2026 22:47
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.

1 participant