Skip to main content

Documentation Index

Fetch the complete documentation index at: https://hypha-docs.plinqx.app/llms.txt

Use this file to discover all available pages before exploring further.

Connect your Plinqx tools to Claude, allowing Claude Desktop and Claude API to discover and use your tools.

​
Overview

Claude integration enables:
  • Claude Desktop: Use tools in Claude Desktop app
  • Claude API: Access tools via Claude API
  • Claude Console: Use tools in Anthropic’s console

​
Prerequisites

Before connecting:
  • A Plinqx account with tools configured
  • An API key scoped to Collections containing your tools
  • Tools exposed to Claude (see Store Exposure)

​
Configuration Steps

1

Generate API Key

Create an API key in Plinqx scoped to your Collections.See API Keys for details.
2

Configure MCP Endpoint

Claude uses the MCP protocol. Your Plinqx MCP endpoint is:
https://hypha-api.plinqx.app/mcp
Or your custom domain if configured.
3

Add to Claude Desktop

In Claude Desktop settings, add Plinqx as an MCP server:
  • Server URL: Your Plinqx MCP endpoint
  • API Key: Your Plinqx API key
4

Verify Connection

Claude will discover tools from your Collections.

​
Safety Annotations

Claude supports safety annotations for tools:
  • Read-only: Tool only reads data
  • Destructive: Tool may perform destructive operations
  • Idempotent: Same call produces same result
  • Open World: Tool interacts with external entities
Configure these in tool store exposure settings.
Use safety annotations to help Claude make better decisions about when to use your tools.

​
Testing the Integration

Test your integration:
1

Use Playground

Test tools in Plinqx Playground with Claude context enabled.
2

Test in Claude

Ask Claude to use your tools and verify execution.

​
Troubleshooting

​
Tools Not Appearing

If tools don’t appear in Claude:
  • Verify API key is valid and active
  • Check tools are exposed to Claude store
  • Ensure Collections are linked to the API key
  • Verify tools are published and enabled

​
Authentication Errors

If you see authentication errors:
  • Verify API key is correct
  • Check API key hasn’t been revoked
  • Ensure API key has access to the Collections

​
Execution Errors

If tool execution fails:
  • Check tool configuration in Plinqx
  • Verify credentials are valid
  • Review error messages in Plinqx audit logs

​
Best Practices

Use Safety Annotations

Configure safety annotations for better Claude decision-making

Test First

Test tools in Playground before exposing to Claude

Monitor Usage

Review tool usage in audit logs

Set Policies

Configure policies for rate limiting and approvals

​
Next Steps

Configure Store Exposure

Manage which tools are exposed to Claude

Set Up Policies

Add governance policies for Claude tool usage