Idiolect AI

Idiolect AI MCP 服务

使用可移植的写作档案，以你的风格撰写和修改电子邮件、消息、帖子、回复和文档。Idiolect AI 会根据你的请求直接创作新内容，也可以修改你提供的文本。写作前无需获取档案。

通过托管 OAuth 连接

在支持远程 HTTP MCP 和 OAuth 的客户端中使用 https://idiolect.app/api/mcp。 客户端会打开浏览器供你登录，并管理连接。此方式无需安装 npm、API 密钥 或客户端密钥。请查看授权同意页面和客户端的工具权限。如果 Idiolect AI 已连接， 请勿添加第二个连接。

Codex

codex mcp add idiolect --url https://idiolect.app/api/mcp
codex mcp login idiolect

参阅 Codex MCP 指南。

Cursor

将以下内容添加到 .cursor/mcp.json，然后在 Cursor 的 MCP 设置中完成 OAuth 登录：

{
  "mcpServers": {
    "idiolect": {
      "url": "https://idiolect.app/api/mcp"
    }
  }
}

参阅 Cursor MCP 指南。

使用 GitHub Copilot 的 VS Code

将以下内容添加到 .vscode/mcp.json。从 MCP 控件启动服务并完成登录：

{
  "servers": {
    "idiolect": {
      "type": "http",
      "url": "https://idiolect.app/api/mcp"
    }
  }
}

参阅 VS Code MCP 配置参考。

OpenCode

将以下内容添加到项目中的 opencode.json：

{
  "$schema": "https://opencode.ai/config.json",
  "mcp": {
    "idiolect": {
      "type": "remote",
      "url": "https://idiolect.app/api/mcp",
      "enabled": true
    }
  }
}

然后运行 opencode mcp auth idiolect，并通过 opencode mcp list 检查连接。 参阅 OpenCode MCP 指南。

这些示例用于配置连接。已连接的工具目录并不能证明每个客户端都具备完整的 写作工作流。客户端的模型访问权限和工具审批也同样适用。

写作工具

请参阅 Cursor 插件指南，了解仅含 MCP 的软件包和当前兼容状态。

托管 OAuth 和 API 密钥账户模式会提供以下六种工具：

• write 根据你的请求、事实或笔记创作内容。
• rewrite 修改你提供的文字。你的指示会单独放在 instructions 中。
• refine_writing 使用最新的写作参考修改 Idiolect AI 返回的内容。
• record_writing_feedback 记录你对该内容的反馈：结果、最终措辞或备注。
• view_writing_profile 查看当前的写作档案、规则或样本。
• manage_profile 创建或修改写作档案和明确提出的规则。

如果你没有写作档案，服务会提供根据你自己的写作或回答进行设置的选项。 你可以跳过设置，在没有档案的情况下继续写作。完成三篇内容后，写作完成后可能会 出现一条可选提醒。忽略提醒后不会再次出现；拒绝提醒则会停止后续提醒。请遵循返回的 设置选项和参考内容。拒绝提醒时，setup.purpose 为 reminder，setup.choice 为 plain； 不会重写已完成的内容。整个档案只能在网站上删除。

请使用自己创作的文字作为档案依据。你提出请求时，宿主可以获取这些内容。 请检查检索到的内容，然后批准要发送用于生成写作档案的具体内容。提交依据时，宿主仅在获得 批准后才会将 evidence.userApproved 设为 true。对于你之前发送给他人的消息， 宿主会使用 evidence.source sent_writing。 对于你为当前请求提供或批准的其他材料，宿主会使用 current_request。 这些值遵循依据契约，不用于标识外部存储服务。 请勿将 AI 或第三方撰写的文字保存为你自己的写作，也不要将推断出的风格模式转化为你明确提出的规则。

服务会返回完成后的内容。呈现时请保留其措辞，并使用 refine_writing 进行后续修改。普通写作不会报告语气匹配分数。 发送或发布结果是客户端中的独立操作。

npm 和 API 密钥账户模式

idiolect-mcp npm 包是连接托管服务的本地 stdio 桥接程序。当 客户端需要本地进程，而不是托管 OAuth 时，请使用它。此模式要求 Node.js 18 或更高版本 以及 Idiolect AI API 密钥；它本身不会执行浏览器 OAuth。

{
  "mcpServers": {
    "idiolect": {
      "command": "npx",
      "args": ["-y", "idiolect-mcp"],
      "env": {
        "IDIOLECT_API_KEY": "<your-api-key>"
      }
    }
  }
}

请通过客户端的私有凭据配置替换占位符。切勿提交实际密钥。IDIOLECT_BASE 可更改服务 URL，以指向可自托管的实例；其默认值为 https://idiolect.app。

旧版 slug 模式

如果没有 API 密钥，stdio 包会提供单独的旧版目录。IDIOLECT_SLUG 用于选择公开的 Voice Card；它不会选择经过身份验证的账户中的 Writing Profile。可选的 IDIOLECT_SAMPLES_FILE 或 IDIOLECT_SAMPLES 用于提供无状态评分所需的样本。 此兼容路径不同于上文提到的五个账户工具。对于当前的写作和资料工作流，建议使用托管 OAuth。

隐私、支持与维护

写作请求和获准使用的证据会发送到托管服务。客户端负责管理自己的 OAuth 令牌和工具权限。请阅读隐私政策 和服务条款。如需帮助，请使用支持页面 或发送邮件至 [email protected]。

如需贡献，请确保设置示例与上述写作工具和证据规则保持一致。 检查示例是否使用受支持的字段，并保留用户的批准内容和返回的写作内容。 生成的目录文件来自产品仓库中的规范契约。 请在问题单中报告目录变更，而不要手动编辑生成的文件。

采用 MIT 许可。