Acidni MCP Portal

Acidni MCP门户

MCP发现门户 按用户密钥管理 -用户仪表板、自助APIM密钥生命周期和Acidni MCP服务器的自动发现。

特性

• 每个用户的APIM密钥：每个用户为每个MCP服务器获得唯一的API密钥（无共享密钥）
• 自助服务密钥生命周期：从仪表板生成、旋转和撤销密钥
• 审计跟踪：每个关键操作都记录到Cosmos DB中以符合要求
• 用户黑板：使用Microsoft登录以查看可用的MCP服务器并管理您的密钥
• 自动发现: /.well-known/mcp MCP客户端自动发现服务器的端点
• 复制粘贴配置：Claude Desktop、VS Code和cURL的预格式化配置-使用您的密钥进行个性化设置
• 健康监测：所有注册的MCP服务器的实时运行状况

可用的MCP服务器

______________________________________________________________________

每个用户密钥管理

为什么是每个用户密钥？

以前，所有用户在每台服务器上共享相同的APIM订阅密钥。这违反了 秒-003 （按产品APIM订阅密钥），并且无法：

• 在不影响所有人的情况下撤销单个用户的访问权限
• 跟踪哪个用户进行了哪些API调用
• 在不干扰所有用户的情况下旋转受损密钥

现在，每个用户在每台服务器上都有自己唯一的APIM订阅，范围为正确的APIM产品。密钥是按需创建的，可以独立旋转或撤销。

建筑

graph TD
    U[User signs in via Entra ID] --> P[MCP Portal
mcp.acidni.net]
    P -->|"Generate Key"| APIM[Azure APIM
apim-terprint-dev]
    APIM -->|"Creates subscription scoped to Product"| SUB["APIM Subscription
mcp-{oid}-{server}"]
    P -->|Stores key record| COSMOS[(Cosmos DB
mcp-portal-dev)]
    P -->|Logs audit event| AUDIT[(audit-log container)]

    U2[User's MCP Client
Claude / VS Code] -->|"Per-user key in header"| APIM
    APIM -->|Routes to correct backend| MCP1[Terprint MCP]
    APIM --> MCP2[SDO MCP]
    APIM --> MCP3[Solar MCP]
    APIM --> MCP4[RepoLens MCP]

关键生命周期

订阅命名

APIM订阅使用确定性命名模式：

mcp-{first 12 chars of user OID}-{server-id}

例子： mcp-a1b2c3d4e5f6-terprint-mcp

这确保了每个用户+服务器组合映射到一个订阅，并重新生成创建/更新，而不是复制。

数据流

1. 用户登录： mcp.acidni.net 通过输入ID（MSAL）
2. 仪表板显示所有4台MCP服务器的关键状态（绿色=活动，红色=无）
3. 用户点击 生成密钥 在服务器上
4. 门户调用APIM Management API以创建范围为服务器的APIM产品的订阅
5. 通过APIM获取键值 listSecrets
6. 存储在Cosmos DB中的关键记录（提示+元数据） user-keys 容器
7. 审计事件记录到Cosmos DB audit-log 容器
8. 用户从服务器详细信息页面复制其个性化配置（Claude Desktop、VS Code或cURL）
9. MCP客户端使用每个用户密钥发送请求 Ocp-Apim-Subscription-Key 头球
10. APIM验证密钥，根据产品到API的映射路由到正确的后端

共享密钥（仅健康检查）

门户仍然保存来自密钥库的共享APIM订阅密钥(apim-*-subscription-key).这些被使用 仅 用于服务器端健康检查代理(/api/health/{id}).它们永远不会暴露给用户或包含在导出的配置中。

______________________________________________________________________

快速开始

对于用户

1. 访问 https://mcp.acidni.net
2. 使用您的Microsoft帐户登录
3. 在仪表板上，单击 生成密钥 在要使用的每个MCP服务器旁边
4. 转到服务器详细信息页面并复制您的配置代码段
5. 粘贴到MCP客户端配置文件中

配置Claude桌面

在门户上生成密钥后，转到每个服务器的详细信息页面。门户生成一个即贴即用的 claude_desktop_config.json 使用您的个人密钥的片段：

{
  "mcpServers": {
    "terprint-mcp": {
      "command": "npx",
      "args": ["-y", "@anthropic-ai/mcp-proxy@latest", "--header",
               "Ocp-Apim-Subscription-Key: YOUR_PERSONAL_KEY_HERE",
               "https://api.acidni.net/terprint-mcp/mcp"]
    }
  }
}

每个服务器都有自己的唯一密钥。做 不 重用旧的共享密钥-从门户生成新的每个用户密钥。

配置VS代码

该门户还生成VS代码MCP设置。从服务器详细信息页面复制：

{
  "mcp": {
    "servers": {
      "terprint-mcp": {
        "type": "sse",
        "url": "https://api.acidni.net/terprint-mcp/mcp",
        "headers": {
          "Ocp-Apim-Subscription-Key": "YOUR_PERSONAL_KEY_HERE"
        }
      }
    }
  }
}

自动发现（适用于MCP客户端）

MCP客户端可以通过以下方式发现可用服务器：

GET https://mcp.acidni.net/.well-known/mcp

______________________________________________________________________

API终点

门户网站和Web

数据API

密钥管理API

______________________________________________________________________

基础设施

Azure资源

Cosmos数据库

APIM产品

每个MCP服务器都映射到一个APIM产品。每个用户的订阅仅限于这些产品，因此APIM会自动处理到正确后端API的路由。

所需的RBAC角色分配

容器应用程序的托管身份(ca-mcp-portal)需求：

______________________________________________________________________

发展

先决条件

• Python 3.12+
• Azure CLI（用于密钥库和托管身份访问）

本地设置

# Clone the repository
git clone https://github.com/Acidni-LLC/acidni-mcp-portal.git
cd acidni-mcp-portal

# Create virtual environment
python -m venv venv
venv/Scripts/Activate.ps1  # Windows
source venv/bin/activate   # Linux/Mac

# Install dependencies
pip install -e ".[dev]"

# Create .env file
cat > .env << EOF
ENVIRONMENT=development
DEBUG=true
KEYVAULT_NAME=kv-terprint-dev
EOF

# Run locally
python -m src.main

环境变量

密钥库秘密

项目结构

src/
  main.py                  # FastAPI app, lifespan init for Cosmos + APIM manager
  config.py                # Settings loaded from env + Key Vault
  auth.py                  # Entra ID / MSAL authentication
  registry.py              # MCP server registry (static catalog)
  routes/
    __init__.py             # Exports api_router, keys_router, web_router
    api.py                  # Data API routes (servers, configs, health proxy)
    keys.py                 # Key lifecycle API (generate, rotate, revoke)
    web.py                  # HTML page routes (dashboard, server detail)
  services/
    key_manager.py          # APIM Management REST API client
    cosmos_client.py        # Cosmos DB user-keys + audit-log client
  templates/
    dashboard.html          # Dashboard with key status + HTMX key management
    server_detail.html      # Server detail with key display + config snippets
    ...

部署

通过GitHub Actions部署到Azure容器应用程序：

• 容器应用: ca-mcp-portal
• 资源组: rg-dev-acidni-shared
• 自定义域名: mcp.acidni.net
• ACR图像: cracidnidev.azurecr.io/acidni-mcp-portal

______________________________________________________________________

安全

• 用户访问没有共享密钥 -每个用户都获得唯一的APIM订阅密钥（SEC-ASR-003）
• APIM验证所有请求 -MCP服务器位于内部入口后面，只能通过APIM（SEC-ASR-001）访问
• 处处管理身份 -门户使用 DefaultAzureCredential 适用于APIM、Cosmos和密钥库
• 审计日志 -每个键的创建/旋转/撤销都会与用户OID、电子邮件、时间戳一起记录到Cosmos DB中
• 撤销时软删除 -订阅被暂停，而不是被销毁，允许进行取证审查
• 仅在Cosmos中提供关键提示 -仅存储最后4个字符；APIM是完整键值的真实来源

许可证

专有-Acidni有限责任公司