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 Google Gemini, allowing Gemini to discover and use your tools.

​
Overview

Gemini integration enables:
  • Gemini API: Access tools via Google’s Gemini API
  • Gemini Studio: Use tools in Google’s Gemini Studio
  • Gemini Apps: Integrate tools into Gemini-powered applications

​
Prerequisites

Before connecting:
  • A Plinqx account with tools configured
  • An API key scoped to Collections containing your tools
  • Tools exposed to Gemini (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

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

Add to Gemini

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

Verify Connection

Gemini will discover tools from your Collections.

​
Testing the Integration

Test your integration:
1

Use Playground

Test tools in Plinqx Playground with Gemini context enabled.
2

Test in Gemini

Ask Gemini to use your tools and verify execution.

​
Troubleshooting

​
Tools Not Appearing

If tools don’t appear in Gemini:
  • Verify API key is valid and active
  • Check tools are exposed to Gemini 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 Descriptive Names

Use clear tool names and descriptions for better AI understanding

Test First

Test tools in Playground before exposing to Gemini

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 Gemini

Set Up Policies

Add governance policies for Gemini tool usage