Natura AI

Intelligent Conversational Assistant

User Guide

Version 1.0 | December 2025

1. Getting Started3
2. The Chat Interface4
3. Conversations Management5
4. MCP Integration6
5. Advanced Features8
6. Tips & Best Practices9
7. Troubleshooting10

1. Getting Started

Accessing Natura AI

Open your web browser and navigate to:

Application URL

https://natura-ai-frontend.pages.dev

Creating an Account

Click "Create Account" on the login page

Enter your details: Username, Display Name, and Password (minimum 6 characters)

Click "Create Account"

You'll be automatically logged in and ready to chat!

Demo Account

For testing purposes, you can use:

Username: yash
Password: test1234

2. The Chat Interface

Starting a Conversation

Once logged in, you'll see the main chat interface with these key elements:

+ New Chat

Click this button in the sidebar to start a fresh conversation

Message Input

Type your message in the input field at the bottom of the screen

Send Button

Press Enter or click the send button to submit your message

Conversation List

View and switch between your conversations in the sidebar

Real-Time Streaming

Natura AI uses streaming responses, which means:

You see the AI's response as it's being generated in real-time
No waiting for the complete response to load
Natural, conversational flow that feels like chatting with a human

Smart Conversation Titles

When you start a new conversation, Natura AI automatically generates a descriptive title based on your first message. This makes it easy to find and organize conversations later.

3. Conversations Management

Sidebar Navigation

The left sidebar shows all your conversations:

Recent conversations appear at the top
Click any conversation to continue it
All conversations are automatically saved

Conversation Actions

Action	Description
Continue	Click on a conversation to resume where you left off
Delete	Remove conversations you no longer need
Archive	Keep conversations but hide them from the main view

4. MCP Integration

What is MCP?

MCP (Model Context Protocol) allows Natura AI to connect to external tools and services, extending its capabilities beyond text generation. Think of it as giving the AI superpowers!

Built-in Calculator

Natura AI comes with a built-in Natura Calculator MCP server that provides these tools:

Tool	Description	Example Usage
`add`	Add two numbers	"What is 156 + 289?"
`subtract`	Subtract numbers	"Subtract 50 from 200"
`multiply`	Multiply numbers	"Multiply 15 by 23"
`divide`	Divide numbers	"Divide 100 by 4"
`get_current_time`	Get current date/time	"What time is it?"

Enabling the Calculator

Open the MCP Servers panel in the interface

Find "Natura Calculator" under Built-in Servers

Click "Enable" to add it

Click "Connect" to activate the tools

Status will change to "Added" (green badge)

Using MCP Tools

Once connected, simply ask naturally in the chat:

"What is 156 + 289?"

The AI will respond with something like:

"I used the add tool from the Natura Calculator to compute this. The result of 156 + 289 is 445."

Disconnecting MCP Servers

To disable an MCP server:

Open MCP Servers panel
Click the trash icon next to the server
The server will be removed and tools disabled

5. Advanced Features

Model Information

Natura AI uses GPT-4o by default, providing:

Advanced Reasoning

Complex problem-solving and analytical capabilities

Nuanced Understanding

Comprehends context and subtle meanings

High-Quality Responses

Well-structured, accurate, and helpful answers

Fast Response Times

Quick generation with streaming support

Context Awareness

The AI maintains context throughout your conversation:

Remembers all previous messages in the conversation
Understands references to earlier topics
Builds on previous responses for coherent dialogue

Markdown Support

The AI supports rich formatting in responses:

Bold text for emphasis
Italic text for subtle emphasis
Code snippets for technical content
Structured lists and tables
Code blocks for longer examples

6. Tips & Best Practices

Getting Better Responses

Tip	Why It Helps
Be Specific	Clear, detailed questions get more accurate answers
Provide Context	Background information helps the AI understand your needs
Ask Follow-ups	Build on previous responses for deeper exploration
Use Examples	Show what format or style you're looking for

Effective MCP Usage

Pro Tip: Use natural language when asking for calculations. Say "What is 15 times 23?" instead of trying to use technical commands. The AI will automatically use the appropriate tool!

Conversation Organization

One Topic Per Chat: Keep conversations focused for easier reference
Use Descriptive Names: Rename if auto-generated title isn't clear
Archive Old Chats: Keep your workspace clean
Delete Test Conversations: Remove unnecessary clutter

7. Troubleshooting

Common Issues & Solutions

Empty Response on MCP Calls

Solution: Ensure MCP server is Connected (not just Added). Check for green "Added" badge and try refreshing the connection.

Login Issues

Verify username and password are correct
Check for typos (passwords are case-sensitive)
Try clearing browser cookies and cache

Slow Responses

Check your internet connection
Try a shorter message first to test
Wait for streaming to complete before sending another message

MCP Connection Failed

For built-in calculator: Try disconnecting and reconnecting
For custom servers: Verify the server URL is correct and accessible
Check that the MCP server is running

Quick Reference Card

Keyboard Shortcuts

Action	Shortcut
Send Message	`Enter`
New Line in Message	`Shift + Enter`
New Chat	Click "+ New Chat" button

MCP Tool Commands

To Do This	Say Something Like
Add numbers	"What is 25 + 75?"
Subtract	"Subtract 30 from 100"
Multiply	"Multiply 12 by 8"
Divide	"Divide 144 by 12"
Get time	"What time is it now?"

Technical Specifications

Architecture

Component	Technology
Frontend	React + TypeScript + Vite
Backend	Cloudflare Workers + Hono
Database	Supabase (PostgreSQL)
AI Model	OpenAI GPT-4o
Styling	Tailwind CSS
Animations	Framer Motion

Security Features

JWT-based authentication
Secure password hashing (bcrypt)
CORS protection
Input validation and sanitization