乔普林连接
Claude代码技能和MCP服务器管理 乔普林 笔记、笔记本、标签、资源和搜索——所有这些都来自您的终端。
提供了两种集成方法：
| 方法 | 工作原理 | 最适合 |
|---|---|---|
| 技能 （推荐） | Markdown提示教Claude Code通过 curl | 零依赖，易于阅读和定制 |
| MCP服务器 | 一个将Joplin操作作为工具公开的TypeScript MCP服务器 | 结构化工具调用，可在MCP兼容客户端之间重用 |
先决条件
- 乔普林 已安装并正在运行桌面应用程序
- Web Clipper服务 启用：乔普林→ 工具→ 选项→ 网页剪辑器→ *启用Web Clipper服务*
- API令牌：在工具中找到→ 选项→ 网页剪辑器→ 高级选项→ *API令牌*
- 克劳德代码 已安装CLI
设置
设置您的Joplin API令牌
添加到您的shell配置文件(~/.zshrc, ~/.bashrc等等）：
export JOPLIN_TOKEN="your_api_token_here"或者在中配置它 .claude/settings.local.json:
{
"env": {
"JOPLIN_TOKEN": "your_api_token_here"
}
}乔普林在港口监听 41184 默认情况下。集 JOPLIN_PORT 如果你的不同。______________________________________________________________________
选项A：技能
将技能文件夹复制到项目的 .claude/skills/ 目录：
# From this repo's root
cp -r skills/* /path/to/your/project/.claude/skills/然后在Claude Code中使用它们：
> /joplin create a note titled "Hello" in the Work notebook
> /joplin-search find notes tagged "important"可用技能
| 技能 | 描述 |
|---|---|
joplin | 主要入口点——将请求路由到子技能，处理直接查询 |
joplin-create-note | 创建、更新和删除笔记 |
joplin-search | 使用Joplin的查询语法搜索笔记、笔记本和标签 |
joplin-manage-notebooks | 创建、列出、重命名、移动和删除笔记本 |
joplin-manage-tags | 创建、列出、重命名、删除标签；标记/取消标记注释 |
joplin-manage-resources | 上传、下载、列出和删除文件附件 |
______________________________________________________________________
选项B:MCP服务器
安装
cd mcp
npm install
npm run build使用克劳德代码注册
claude mcp add joplin -- node /absolute/path/to/joplin-skills/mcp/build/index.js确保 JOPLIN_TOKEN 在启动Claude Code之前在您的环境中设置，或在中配置 .claude/settings.local.json.
MCP工具
服务器公开了这些工具： joplin_get_note, joplin_list_notes, joplin_create_note, joplin_update_note, joplin_delete_note, joplin_search, joplin_list_notebooks, joplin_create_notebook, joplin_update_notebook, joplin_delete_notebook, joplin_get_notebook_notes, joplin_list_tags, joplin_create_tag, joplin_tag_note, joplin_untag_note, joplin_list_resources.
______________________________________________________________________
项目结构
joplin-skills/
├── README.md
├── .gitignore
├── skills/ # Skill definitions (browse on GitHub)
│ ├── joplin/
│ │ ├── SKILL.md # Main skill — routing & direct operations
│ │ └── api-reference.md # Full Joplin REST API reference
│ ├── joplin-create-note/
│ │ └── SKILL.md
│ ├── joplin-search/
│ │ └── SKILL.md
│ ├── joplin-manage-notebooks/
│ │ └── SKILL.md
│ ├── joplin-manage-tags/
│ │ └── SKILL.md
│ └── joplin-manage-resources/
│ └── SKILL.md
├── mcp/ # MCP server (TypeScript)
│ ├── src/index.ts
│ ├── package.json
│ └── tsconfig.json
└── .claude/
└── skills/ # Same as skills/ — used by Claude Code at runtime许可证
麻省理工学院