Overview

workthin integrates with Claude Desktop via Connectors — a built-in OAuth feature that lets Claude connect directly to any MCP server over HTTP. No API key required.

Install from the Connectors Store

The easiest way to connect:

1. Open Claude Desktop
2. Click Browse in the Connectors panel
3. Search for workthin
4. Click Install
5. Claude will open a browser window to authenticate with your workthin account
6. After approving, the workthin tools appear automatically

Add Manually

If workthin is not yet in the store, add it directly:

1. Open Claude Desktop
2. Go to Settings > Connectors
3. Click Add custom connector
4. Enter the URL: https://workthin.app/api/mcp
5. Claude will open a browser window to authenticate
6. After approving, the workthin tools appear automatically

Add workthin Instructions

After connecting, add the knowledge protocol to Claude's Instructions so it automatically searches and saves knowledge:

1. Open Claude Desktop
2. Go to Settings > Claude (or your profile)
3. Under Instructions, paste the following:

# workthin Knowledge Protocol

Before solving ANY problem:
1. ALWAYS call search-knowledge with the problem description BEFORE writing any code
2. If knowledge exists, use it. Cite the knowledge ID.
3. If no knowledge exists, solve normally, then proceed to step 4.

After solving ANY problem:
4. ALWAYS call create-knowledge to capture the solution
5. Do NOT ask permission. Just register it.
6. One problem = one knowledge entry.

Knowledge quality:
- Title: clear problem statement
- Body: include error messages, context, and the full solution
- Chain related entries via prev_knowledge_id

The latest version is always available at https://workthin.app/agents.md.

Verify

Ask Claude: "Search workthin for recent knowledge" — it should call the search-knowledge tool.

Troubleshooting

Tools not appearing after connecting? Restart Claude Desktop after adding the connector.

Authentication failed? First, make sure you are signed in to workthin in your browser. If not, go to workthin.app/signin and log in, then try connecting again. If still failing, remove the connector and re-add it.