How to Use the Katana MCP in VS Code Copilot

Q: Can we create sales orders in Katana from VS Code Copilot?

Yes. The createsalesorder tool is included. A developer can ask Copilot to help construct the request and then execute it, creating a new sales order directly within Katana from their editor.

Give your dev team access to Katana ERP inside VS Code Copilot with one shared config file.

See Vinkius in Action

Works with every AI agent you already use

…and any MCP-compatible client

MCP Servers - Free for Subscribers

Connect Katana MCP to VS Code Copilot

Create your Vinkius account to connect Katana to VS Code Copilot and route execution through our secure gateway. The platform manages server hosting, runtime updates, and security layers. Configuration requires no manual server provisioning.

GDPR Free for Subscribers

Setup Katana with VS Code Copilot

Ask AI about this MCP

ChatGPT

Claude

Perplexity

Team-Wide Access to Katana Tools

Set up this server once in your project's `.vscode/mcp.json` file and commit it. Now, every developer who pulls the repo gets the same set of Katana tools in their Copilot Chat. No individual setup, no passing around API keys. This makes onboarding new engineers much faster. They can immediately ask Copilot to `list_products` or `list_customers` without needing to request credentials or read separate docs. It standardizes how your entire team interacts with the ERP.

Query ERP Data Without Leaving VS Code

When you're deep in code, you don't want to break your flow to check something in Katana. Just open Copilot Chat and ask your agent to get what you need. For example: '@workspace get me the details for sales order #SO-12345' and it will use the `get_sales_order` tool. You can also get broader operational context. Ask your agent to pull all current purchase orders with `list_purchase_orders` or check on material stock with `list_materials`. The responses appear right in your editor, exactly where you need them.

Draft Scripts and Automations

Your team can use Copilot to write internal scripts that use live Katana data. Tell the agent to use `get_inventory_by_variant` to check stock for a list of SKUs and then generate a report. It's a quick way to build reliable internal tooling. Because Copilot is calling the actual tools via this MCP server, the code it suggests for handling API responses is accurate. It's a solid foundation for building scripts that monitor manufacturing orders (`list_manufacturing_orders`) or manage suppliers (`list_suppliers`).

Setup guide

Set up Katana MCP in VS Code Copilot

Prerequisites

VS Code 1.99 or later with GitHub Copilot extension
Active Vinkius subscription with a valid endpoint token

1

Open MCP configuration

Open the Command Palette (Cmd+Shift+P / Ctrl+Shift+P) and run "MCP: Add Server". Select HTTP (Streamable) as the server type. VS Code will create .vscode/mcp.json in your workspace.
2

Add the Katana MCP

Paste the JSON snippet shown on the right into your .vscode/mcp.json. Replace [YOUR_TOKEN_HERE] with your endpoint token from cloud.vinkius.com.
3

Switch to Agent mode

Open Copilot Chat (Cmd+Shift+I / Ctrl+Shift+I) and switch to Agent mode using the dropdown. MCP tools are only available in Agent mode — they do not appear in Edit or Ask modes.
4

Verify the connection

In the Copilot Chat input, type # to list available tools. You should see the Katana tools listed. Try asking: "List my recent Katana transactions" and Copilot will invoke them automatically.

.vscode/mcp.json

{
  "mcpServers": {
    "katana-mcp": {
      "url": "https://edge.vinkius.com/[YOUR_TOKEN_HERE]/mcp"
    }
  }
}

Get your connection token →

Independent Platform Disclaimer: Vinkius is an independent platform and is not affiliated with, endorsed by, sponsored by, verified by, or otherwise authorized by Katana. All third-party trademarks, logos, and brand names are the property of their respective owners. Their use on this website is strictly for informational purposes to identify service compatibility and interoperability.

Why Choose Vinkius

Vinkius connects your tools to AI with real-time monitoring and automatic cost savings — all from one dashboard.

Connect Katana now

Real-time monitoring

Live

visibility into every interaction

Connect your favorite tools to your AI and see exactly what's happening — every request, every response, in real time.

Built-in savings

60%

lower AI costs

Vinkius compresses data between your apps and your AI automatically. Lower bills every month — no configuration required.

Single dashboard

One

place for every integration

Every tool your AI connects to, managed from a single screen. One account, complete control.

Common questions about Katana MCP in VS Code Copilot

An admin or lead developer adds the server configuration to a `.vscode/mcp.json` file in your project's repository. Once that file is committed and pushed, every team member using VS Code Copilot in that repo automatically gets access to the Katana tools.

Yes. The `create_sales_order` tool is included. A developer can ask Copilot to help construct the request and then execute it, creating a new sales order directly within Katana from their editor.

Yes. The MCP architecture is designed for enterprise environments. The server runs in an isolated sandbox, and Vinkius manages authentication. It fits within a zero-trust security model, and since it's a standard VS Code extension point, it works with existing policies.

The biggest benefit is team-wide consistency. By defining the Katana tools in a shared config file, you ensure every developer is working with the same data and capabilities. It eliminates configuration drift and helps everyone code against your ERP in a standardized way.

Security is handled at the server level. The MCP server runs in a dedicated, single-use sandbox for each request. It only has permission to access the data needed for the specific tool being used, like supplier lists or inventory levels. Your Katana token is managed by Vinkius and is never directly visible.

Use it with your favorite AI tools

Connect this server to Cursor, Claude, VS Code, and more.

OpenAI Agents SDK sdk-python

Google ADK sdk-python

Pydantic AI sdk-python

Vercel AI SDK sdk-typescript