跳到主要内容

almirant init

为当前仓库配置 Almirant MCP 集成。这是一体化流程：按需包含身份验证、账户选择、项目选择和配置文件生成。

用法​

almirant init [--api-url <url>] [--app-url <url>] [--name <nombre>]

功能​

  1. 检测项目类型。
  2. 检查 .mcp.json 是否已存在；如果存在，会询问是否继续并合并 Almirant 条目。
  3. 允许选择已存储的账户或添加新账户。
  4. 针对服务器验证凭据。
  5. 显示可供选择或创建的项目。
  6. 使用 almirant mcp proxy 生成 .mcp.json，不写入令牌。
  7. 将 Skills 复制到 .claude/skills/ 和 .agents/skills/。

生成的 .mcp.json 文件​

{
  "mcpServers": {
    "almirant": {
      "type": "stdio",
      "command": "almirant",
      "args": ["mcp", "proxy", "--project-id", "<project-id>", "--account", "<account-id>"]
    }
  }
}

API key 不会出现在仓库中。代理会从 ~/.almirant/config.json 读取账户，并且仅在内存中附加 bearer token。

  • 在团队中首次配置 Almirant，或希望 CLI 连同登录一起引导你时，使用 init。
  • 当你已有已存储的凭据，只想快速关联一个新仓库时，使用 link。