{% extends "base.html" %} {% load static %} {% block title %}MCP 接入说明 - AgomTradePro{% endblock %} {% block extra_css %} {% endblock %} {% block content %}

MCP 接入说明

把当前账户可用的 MCP / SDK 接入参数集中到一个页面,直接复制给 Codex、Claude Code 或其他支持 MCP 的 Agent 即可使用。

{% if new_token_payload %}
新 Token 已生成: {{ new_token_payload.token_name }} / {{ new_token_payload.access_level_label }}
{{ new_token_payload.token }}
{% endif %}
MCP/SDK 权限
{% if profile.mcp_enabled %}已开启{% else %}已关闭{% endif %}
关闭后,所有 Token 会立即失效。
当前活跃 Token
{{ access_tokens|length }}
{% if token_plaintext_allowed %}支持查看完整 Token。{% else %}当前系统只允许查看预览串。{% endif %}
默认账户 ID
{% if default_account_id %}{{ default_account_id }}{% else %}未设置{% endif %}
{% if default_account_name %}{{ default_account_name }}{% else %}没有可用投资账户时可留空。{% endif %}
当前角色
{{ profile.get_rbac_role_display }}
MCP 默认可从后端读取该角色,无需手工覆盖。

推荐 Token

{% if preferred_token and preferred_token.plaintext %}

当前优先使用最近的活跃 Token。直接复制这一串即可放入 Agent 配置。

{{ preferred_token.plaintext }}
{% elif access_tokens %}

你已经有活跃 Token,但系统已关闭历史 Token 明文查看。若要重新复制到新 Agent,建议生成一个新 Token 并立即复制。

{{ access_tokens.0.preview }} {{ access_tokens.0.get_access_level_display }}
{% else %}

当前账户还没有可用 Token。下面可以直接一键生成一个专门给 Codex 或其他 Agent 使用的 Token。

{% endif %} {% if profile.mcp_enabled %}
{% csrf_token %}

只读 Token 仅允许 GET/HEAD/OPTIONS;即使账号是管理员,也不会误触发写接口。读写 Token 仍然继续受账号角色权限约束。

{% else %}
管理员已关闭当前账户的 MCP/SDK 访问权限。此时不能创建新 Token,请先联系管理员开启。
{% endif %}

关键参数

MCP 运行形态
stdio 本地进程模式
Base URL
{{ base_url }}
API Root
{{ api_root_endpoint }}
认证头
Authorization: Token <your_token>
SDK 工作目录
{{ sdk_cwd }}
默认账户 ID
{% if default_account_id %} {{ default_account_id }} {% else %} 选填;没有账户时可暂时留空 {% endif %}

Codex / Claude / 通用 MCP 配置

适用于支持 `mcpServers` 结构的桌面 Agent。把下面 JSON 复制到对应的 MCP 配置文件中。

{{ mcp_config_json }}

PowerShell 环境变量

适合本机先设置环境变量,再手工启动 MCP 或 SDK 脚本。

{{ powershell_env_block }}

Bash 环境变量

适合 Linux / macOS / WSL 环境。

{{ bash_env_block }}

Python SDK 示例

直接测试 SDK 是否能正常连上当前后端。

{{ python_sdk_block }}

关键 API Endpoint

调试 Agent 时,先用这些接口确认 Token、RBAC 和账户上下文是否正确。

{{ curl_example }}
账户资料
{{ api_profile_endpoint }}
账户列表
{{ accounts_endpoint }}
Dashboard 摘要
{{ dashboard_summary_endpoint }}

我的 Token 列表

为不同 Agent 单独分配 Token 更利于审计与轮换。比如可以分别创建 `codex-local`、`claude-desktop`、`vps-script`。

{% if visible_tokens %} {% for token in visible_tokens %}
{{ token.name }}
{{ token.access_level_label }} / 创建于 {{ token.created_at|date:"Y-m-d H:i" }} {% if token.last_used_at %},最后使用 {{ token.last_used_at|date:"Y-m-d H:i" }}{% endif %}
{% if token.plaintext %} {{ token.plaintext }} {% else %} {{ token.preview }} {% endif %}
{% if token.plaintext %} {% endif %}
{% csrf_token %}
{% endfor %} {% else %}
当前没有活跃 Token。生成后会立即出现在这里。
{% endif %}
{% endblock %}