anthropics / anthropics/claude-agent-sdk-python

Unclear Documentation: Do Plugin MCP Servers Automatically Receive Permissions?

未關閉
#448 1 則留言 0 個 reaction 已指派 0 人 在 GitHub 檢視
documentation
主要語言
Python
星號
8.1k
分支
1.3k
平均合併
2 天 31 分鐘
30 天內合併 PR
1

描述

## Description

The current documentation is unclear about whether plugins that include MCP servers automatically grant Claude permission to use those MCP server tools, or whether they go through the standard permission system.

## Problem

When reading the documentation for plugins with MCP servers, it's ambiguous whether:

1. **Automatic Permission**: Plugin MCP tools are automatically permitted when the plugin is enabled, or
2. **Standard Permission System**: Plugin MCP tools still go through the standard permission system (permission rules, hooks, `canUseTool` callback, user prompts)

The documentation states that "Plugin MCP servers start automatically when the plugin is enabled" and "Servers appear as standard MCP tools in Claude's toolkit" — but this doesn't clarify the **permission** behavior.

## Specific Questions

1. If my plugin includes an MCP server (defined in `.mcp.json` or inline in `plugin.json`), does Claude automatically get permission to use those MCP tools without user approval?
2. Do plugin MCP tools bypass the `canUseTool` callback or permission rules?
3. Is there a way to make plugin MCP tools require explicit user approval vs. auto-approve?

## Requested Updates

Please update the plugin documentation to explicitly clarify:

1. Whether plugin MCP tools go through the standard permission system or have automatic permissions
2. How to control permissions for plugin MCP tools (if configurable)
3. Any security considerations for plugins that include MCP servers

## Relevant Documentation Pages

- [Plugins in the SDK](https://platform.claude.com/docs/en/agent-sdk/plugins)
- [Plugins Reference](https://code.claude.com/docs/en/plugins-reference)
- [MCP in the SDK](https://platform.claude.com/docs/en/agent-sdk/mcp)
- [Handling Permissions](https://platform.claude.com/docs/en/agent-sdk/permissions)

## Impact

This ambiguity makes it difficult for developers to understand the security model of plugins with MCP servers, which is critical for building safe and predictable agent applications.

Thank you!

貢獻指南

這個儲存庫沒有索引到貢獻指南

評估

這個 Issue 還沒有評估資料。

把新 issue 寄到你的電子郵件信箱

精選適合新手參與的 GitHub issue 摘要。