Skip to content

Commit e6a0822

Browse files
committed
Add scope clarification to auth framework documentation
Add an info admonition at the beginning of the auth framework concept document to explicitly clarify that this documentation covers client-to-MCP-server authentication, not MCP-server-to-backend authentication. This distinction helps readers understand: - What is covered: How clients authenticate to the MCP server - What is not covered: How MCP servers authenticate to external APIs (e.g., GitHub MCP server authenticating to GitHub API) The note indicates that MCP-server-to-backend authentication will be covered in separate future documentation.
1 parent 602ba0b commit e6a0822

File tree

1 file changed

+13
-0
lines changed

1 file changed

+13
-0
lines changed

docs/toolhive/concepts/auth-framework.mdx

Lines changed: 13 additions & 0 deletions
Original file line numberDiff line numberDiff line change
@@ -9,6 +9,19 @@ authorization framework, which secures MCP servers by verifying client identity
99
and controlling access to resources. You'll learn how these systems work
1010
together, why they're designed this way, and the benefits of this approach.
1111

12+
:::info[Scope of this documentation]
13+
14+
This documentation covers **client-to-MCP-server authentication**—how clients
15+
authenticate to the MCP server itself. This is about securing access to the MCP
16+
server's tools and resources.
17+
18+
This is different from **MCP-server-to-backend authentication**, which involves
19+
how the MCP server authenticates to external services or APIs it calls (for
20+
example, a GitHub MCP server authenticating to the GitHub API). That topic will
21+
be covered in separate documentation.
22+
23+
:::
24+
1225
## Understanding authentication vs. authorization
1326

1427
When you secure MCP servers, you need to understand the strong separation

0 commit comments

Comments
 (0)