Claude Code Setup for Finix MCP

Copy

• Copy for LLM

  Copy page as Markdown for LLMs
• View as Markdown

  Open this page as Markdown
• Open in ChatGPT

  Get insights from ChatGPT
• Open in Claude

  Get insights from Claude
• Connect to Cursor

  Install MCP server on Cursor
• Connect to VS Code

  Install MCP server on VS Code

Connect Claude Code to Finix documentation in minutes.

Prerequisites

Before you begin, make sure you have:

• Claude Code installed - Anthropic's CLI tool for AI-assisted development
• Internet connection - Required to reach docs.finix.com

Installing Claude Code

If you don't have Claude Code installed yet:

npm install -g @anthropic-ai/claude-code

Or with Homebrew on macOS:

brew install claude-code

For detailed installation instructions, see Claude Code documentation.

Quick Setup

Add the Finix MCP server with a single command:

claude mcp add finix-redocly-mcp https://docs.finix.com/mcp --transport http

That's it. Claude Code can now access Finix documentation.

Verify the Connection

After adding the MCP server, verify it's working:

Check MCP Status

claude mcp list

You should see finix-redocly-mcp in the list of configured servers.

Test a Query

Start a Claude Code session and ask a question about Finix:

claude

Then try a test prompt:

"What authentication method does the Finix API use?"

If Claude responds with specific details about Finix API authentication (Basic Auth with API credentials), the connection is working.

Configuration Options

Project-Level Configuration

To add the Finix MCP server only to a specific project, navigate to your project directory first:

cd /path/to/your/project
claude mcp add finix-redocly-mcp https://docs.finix.com/mcp --transport http --scope project

This creates a .claude/mcp.json file in your project, so the MCP server is only available when working in that directory.

Global Configuration

To make the Finix MCP server available in all your projects (default behavior):

claude mcp add finix-redocly-mcp https://docs.finix.com/mcp --transport http --scope user

Manual Configuration

You can also manually edit your Claude configuration file.

Location:

• macOS/Linux: ~/.claude.json
• Windows: %USERPROFILE%\.claude.json

Add the Finix MCP server to the mcpServers section:

{
    "mcpServers": {
        "finix-redocly-mcp": {
            "type": "http",
            "url": "https://docs.finix.com/mcp"
        }
    }
}

After editing, restart Claude Code for changes to take effect.

Using Finix MCP

Once configured, Claude automatically uses the MCP server when you ask Finix-related questions.

Example Prompts

API Questions:

"What fields are required to create a Transfer?"

"How do I tokenize a card with Finix.js?"

"What's the difference between a Transfer and an Authorization?"

Integration Help:

"Show me an example of processing a refund"

"How do I set up webhooks for payment status updates?"

"What are the steps to onboard a seller?"

Troubleshooting:

"What does error code 402 mean?"

"Why would a Transfer be in PENDING state?"

"How do I handle declined payments?"

Best Practices

For the best results:

1. Be specific - "How do I create a card Authorization?" is better than "How do payments work?"

2. Reference API resources - Use terms like "Transfer", "Authorization", "Identity", "Merchant" when relevant

3. Ask for examples - "Show me an example of..." prompts Claude to pull code samples from documentation

4. Mention the environment - Specify "Sandbox" or "Production" if it matters for your question

Troubleshooting

MCP Server Not Found

If claude mcp list doesn't show finix-redocly-mcp:

1. Re-run the add command:

   claude mcp add finix-redocly-mcp https://docs.finix.com/mcp --transport http

2. Check your configuration file exists and is valid JSON

Connection Errors

If Claude reports connection issues:

1. Check internet connection - Verify you can reach docs.finix.com in a browser

2. Check for firewall/proxy issues - Corporate networks may block MCP connections

3. Try removing and re-adding:

   Reset Connection

   claude mcp remove finix-redocly-mcp
   claude mcp add finix-redocly-mcp https://docs.finix.com/mcp --transport http

Claude Not Using Finix Documentation

If Claude seems to be guessing instead of searching documentation:

1. Be explicit - Try "Search the Finix documentation for..." in your prompt

2. Check MCP is enabled - Run claude mcp list to verify the server is configured

3. Restart Claude Code - Sometimes a fresh session helps

Outdated Information

The MCP server queries Finix's published documentation. If you notice outdated information:

1. Check docs.finix.com directly to verify current documentation
2. The MCP server reflects published docs, which are updated regularly

Removing the MCP Server

To disconnect Claude Code from Finix documentation:

claude mcp remove finix-redocly-mcp

Next Steps