Using Nuggetz with AI Assistants (MCP)

Nuggetz supports the Model Context Protocol (MCP), allowing you to save nuggets directly from AI assistants like Claude Desktop, Cursor, and other MCP-compatible tools.

What is MCP?

MCP (Model Context Protocol) is an open standard that lets AI assistants connect to external services. With Nuggetz's MCP integration, you can:

Save conversations directly from Claude Desktop or Cursor
Search your nuggets using natural language queries
View your nuggets without leaving your AI assistant
Check your active team to see which team you're working with
Extract insights automatically using AI processing

Getting Started

Step 1: Add Nuggetz to Your AI Assistant

For Claude Desktop

Open Claude Desktop settings
Navigate to Connectors or MCP Servers
Add a new connector with the URL:
```
https://app.nuggetz.ai/api/mcp
```
Claude will automatically discover the available tools

For Cursor

Open Cursor settings
Go to MCP Servers
Add the Nuggetz server URL:
```
https://app.nuggetz.ai/api/mcp
```

Step 2: Authenticate and Select Team

When you first use a Nuggetz tool, you'll be prompted to authenticate:

Click the authentication link
Sign in with your Nuggetz account
Select your team - If you have multiple teams, you'll see a team selector where you can choose which team this connection should use
Click "Authorize" to complete the setup

The selected team is stored with your connection, so all future operations will use that team automatically.

Available Tools

get_current_team

Shows which team is currently active for this connection. Your team is selected during OAuth authentication - to switch teams, you'll need to disconnect and reconnect the integration.

Example prompt:

"Which Nuggetz team am I using?"

search_nuggets

Search your nuggets by text query. Searches across titles, goals, tags, actions, insights, decisions, and questions. Returns relevance-ranked results.

Example prompts:

"Search my Nuggetz for authentication" "Find nuggets about API design" "What do I have saved about Chrome extensions?"

Parameters:

query - Search text (required)
limit - Maximum results to return (default: 10)

save_conversation

Saves a conversation as a nugget with AI processing. The conversation will be analyzed to extract:

Key insights
Action items
Decisions made
Open questions

Example prompt:

"Save this conversation to Nuggetz"

Parameters:

sourceUrl - The URL of the original conversation
messages - The conversation messages
teamId - Which team to save to (uses your connected team if not specified)
forceUpdate - Re-process if already saved (default: false)

list_nuggets

Lists your existing nuggets with pagination and sorting options.

Example prompt:

"Show me my recent nuggets in Nuggetz"

Parameters:

sortBy - Field to sort by: createdAt, updatedAt, or title (default: createdAt)
sortOrder - asc or desc (default: desc)
page - Page number (default: 1)
pageSize - Results per page (default: 10, max: 100)

update_nugget

Updates an existing nugget's title or goal.

Example prompt:

"Update the title of nugget [ID] to 'New Title'"

Working with Teams

Team Selection During Setup

When you first connect Nuggetz to your AI assistant, you'll be asked to select which team to use. This team selection happens during the OAuth flow:

After signing in, you'll see a team selector with all your teams
Select the team you want this AI assistant to use
The selection is saved with your access token

Changing Your Connected Team

To switch teams, you'll need to re-authenticate:

Remove the Nuggetz connection from your AI assistant settings
Add it again
During authentication, select your new team

Multiple Team Members

Each team member authorizes their own connection. Your team selection doesn't affect other team members - they'll choose their own default team when they connect.

Troubleshooting

"Authentication required" error

Your session may have expired. Re-authenticate by:

Using any Nuggetz tool
Following the authentication link
Signing in again and selecting your team

"Team context required" error

The operation needs a team. Either:

Re-authenticate and select a team during setup (disconnect and reconnect the integration)
Use get_current_team to check which team is currently active

Conversation already saved

If you try to save a conversation that's already been saved, Nuggetz will return the existing nugget. To re-process it, use:

"Save this conversation to Nuggetz and force update"

This sets forceUpdate: true and re-processes the conversation.

Connection issues

Verify the MCP server URL is correct: https://app.nuggetz.ai/api/mcp
Check your internet connection
Try removing and re-adding the connector
Ensure you're signed into Nuggetz in your browser

Security

All connections use HTTPS encryption
OAuth 2.0 with PKCE for secure authentication
Team selection is bound to your access token
Tokens expire automatically (1 hour)
You can revoke access by removing the connector from your AI assistant

Supported AI Assistants

Nuggetz MCP works with any MCP-compatible AI assistant, including:

Claude Desktop - Full support
Cursor - Full support
Other MCP clients - Should work with standard MCP implementations

Need Help?

If you're having trouble with MCP integration:

Check our troubleshooting guide above
Contact support at support@nuggetz.ai
Visit our main Help Center

Using Nuggetz with AI Assistants (MCP)

Nuggetz supports the Model Context Protocol (MCP), allowing you to save nuggets directly from AI assistants like Claude Desktop, Cursor, and other MCP-compatible tools.

What is MCP?

MCP (Model Context Protocol) is an open standard that lets AI assistants connect to external services. With Nuggetz's MCP integration, you can:

Save conversations directly from Claude Desktop or Cursor
Search your nuggets using natural language queries
View your nuggets without leaving your AI assistant
Check your active team to see which team you're working with
Extract insights automatically using AI processing

Getting Started

Step 1: Add Nuggetz to Your AI Assistant

For Claude Desktop

Open Claude Desktop settings
Navigate to Connectors or MCP Servers
Add a new connector with the URL:
```
https://app.nuggetz.ai/api/mcp
```
Claude will automatically discover the available tools

For Cursor

Open Cursor settings
Go to MCP Servers
Add the Nuggetz server URL:
```
https://app.nuggetz.ai/api/mcp
```

Step 2: Authenticate and Select Team

When you first use a Nuggetz tool, you'll be prompted to authenticate:

Click the authentication link
Sign in with your Nuggetz account
Select your team - If you have multiple teams, you'll see a team selector where you can choose which team this connection should use
Click "Authorize" to complete the setup

The selected team is stored with your connection, so all future operations will use that team automatically.

Available Tools

get_current_team

Shows which team is currently active for this connection. Your team is selected during OAuth authentication - to switch teams, you'll need to disconnect and reconnect the integration.

Example prompt:

"Which Nuggetz team am I using?"

search_nuggets

Search your nuggets by text query. Searches across titles, goals, tags, actions, insights, decisions, and questions. Returns relevance-ranked results.

Example prompts:

"Search my Nuggetz for authentication" "Find nuggets about API design" "What do I have saved about Chrome extensions?"

Parameters:

query - Search text (required)
limit - Maximum results to return (default: 10)

save_conversation

Saves a conversation as a nugget with AI processing. The conversation will be analyzed to extract:

Key insights
Action items
Decisions made
Open questions

Example prompt:

"Save this conversation to Nuggetz"

Parameters:

sourceUrl - The URL of the original conversation
messages - The conversation messages
teamId - Which team to save to (uses your connected team if not specified)
forceUpdate - Re-process if already saved (default: false)

list_nuggets

Lists your existing nuggets with pagination and sorting options.

Example prompt:

"Show me my recent nuggets in Nuggetz"

Parameters:

sortBy - Field to sort by: createdAt, updatedAt, or title (default: createdAt)
sortOrder - asc or desc (default: desc)
page - Page number (default: 1)
pageSize - Results per page (default: 10, max: 100)

update_nugget

Updates an existing nugget's title or goal.

Example prompt:

"Update the title of nugget [ID] to 'New Title'"

Working with Teams

Team Selection During Setup

When you first connect Nuggetz to your AI assistant, you'll be asked to select which team to use. This team selection happens during the OAuth flow:

After signing in, you'll see a team selector with all your teams
Select the team you want this AI assistant to use
The selection is saved with your access token

Changing Your Connected Team

To switch teams, you'll need to re-authenticate:

Remove the Nuggetz connection from your AI assistant settings
Add it again
During authentication, select your new team

Multiple Team Members

Each team member authorizes their own connection. Your team selection doesn't affect other team members - they'll choose their own default team when they connect.

Troubleshooting

"Authentication required" error

Your session may have expired. Re-authenticate by:

Using any Nuggetz tool
Following the authentication link
Signing in again and selecting your team

"Team context required" error

The operation needs a team. Either:

Re-authenticate and select a team during setup (disconnect and reconnect the integration)
Use get_current_team to check which team is currently active

Conversation already saved

If you try to save a conversation that's already been saved, Nuggetz will return the existing nugget. To re-process it, use:

"Save this conversation to Nuggetz and force update"

This sets forceUpdate: true and re-processes the conversation.

Connection issues

Verify the MCP server URL is correct: https://app.nuggetz.ai/api/mcp
Check your internet connection
Try removing and re-adding the connector
Ensure you're signed into Nuggetz in your browser

Security

All connections use HTTPS encryption
OAuth 2.0 with PKCE for secure authentication
Team selection is bound to your access token
Tokens expire automatically (1 hour)
You can revoke access by removing the connector from your AI assistant

Supported AI Assistants

Nuggetz MCP works with any MCP-compatible AI assistant, including:

Claude Desktop - Full support
Cursor - Full support
Other MCP clients - Should work with standard MCP implementations

Need Help?

If you're having trouble with MCP integration:

Check our troubleshooting guide above
Contact support at support@nuggetz.ai
Visit our main Help Center